前言

《Android源码编译》中我详细叙述了有了源码之后，如何把原生的代码编译成功的过程。现在有了原生的系统镜像之后，我们是不是也应该编一个app在系统中运行呀，好，那就开始吧，一切从HelloWorld开始。

1.创建工程

1.1 搭建最小工程模块

还记得以前学习单片机的时候，都是从最小系统搭起，那么我们创建工程，最小的工程目录会包含哪些东西呢。见下图，至少包含：

  • AndroidManifest.xml配置文件
  • Android.mk 编译脚本文件
  • res目录 用于放资源文件
  • src目录 用于放源码文件

最小代码模块

1.2 编写代码

这个是我在AS中自动生成的工程，代码及其简单。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
//AndroidManifest.xml
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.android.helloworld">

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name">
        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>

</manifest>
1
2
3
4
5
6
7
8
9
10
11
12
//activity_main.xml
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Hello World!"/>

</LinearLayout>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
//MainActivity.java
package com.android.helloworld;

import android.app.Activity;
import android.os.Bundle;

public class MainActivity extends Activity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
    }
}

工程目录树

1.3 编写mk文件

下面介绍部分常用的配置用法

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
LOCAL_PATH:= $(call my-dir)
include $(CLEAR_VARS)

#定义模块标签，build系统根据标签决定哪些模块需要安装
#user:  指该模块只在user版本下才编译
#eng:  指该模块只在eng版本下才编译
#tests: 指该模块只在tests版本下才编译
#optional:指该模块在所有版本下都编译
LOCAL_MODULE_TAGS := optional

# $(call all-java-files-under, <src>)：获取指定目录下的所有java文件。
LOCAL_SRC_FILES := $(call all-java-files-under, src)

#使用指定目录下的manifest文件（如果不与mk文件在同一目录的话必须定义）
LOCAL_MANIFEST_FILE := src/main/AndroidManifest.xml

#资源文件目录，可选定义，不定义也没问题
LOCAL_RESOURCE_DIRS := $(LOCAL_PATH)/src/main/res

#模块名称，apk一般使用LOCAL_PACKAGE_NAME，其它使用LOCAL_MODULE
LOCAL_PACKAGE_NAME := helloworld

#如果导入第三方jar包才使用这句
#定义引用别名   xxxxx为jar包的别名，可以随便取，只要与下面相对应就行
LOCAL_STATIC_JAVA_LIBRARIES := xxxxx

#签署当前应用的证书名称
#用于指定签名时使用的KEY，如果不指定，默认使用testkey，LOCAL_CERTIFICATE可设置的值如下：
#  LOCAL_CERTIFICATE:= platform
#  LOCAL_CERTIFICATE:= shared
#  LOCAL_CERTIFICATE:= media
#而在Android.mk中的这些配置，需要在APK源码的AndroidManifest.xml文件中的manifest节点添加如下内容：
#  android:sharedUserId="android.uid.system"
#  android:sharedUserId="android.uid.shared"
#  android:sharedUserId="android.media"
#这些刚好与上面的mk文件里的配置对应上。
LOCAL_CERTIFICATE := platform

#以声明app需要放在/system/priv-app下
LOCAL_PRIVILEGED_MODULE := true

LOCAL_SDK_VERSION := current

include $(BUILD_PACKAGE)

###############################################################
#如果jar包放在libs目录下，且libs与Android.mk文件是同级目录，则jar包路径如下
###############################################################
include $(CLEAR_VARS)
LOCAL_PREBUILT_STATIC_JAVA_LIBRARIES := xxxxx:libs/3part.jar       // 引用名：jar包名路径
include $(BUILD_MULTI_PREBUILT)
################################################################

我编helloword工程用到的脚本如下。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
LOCAL_PATH:= $(call my-dir)
include $(CLEAR_VARS)

LOCAL_MODULE_TAGS := optional

LOCAL_SRC_FILES := $(call all-java-files-under, src)

LOCAL_PACKAGE_NAME := HelloWorld
LOCAL_SDK_VERSION := current

include $(BUILD_PACKAGE)

# Use the following include to make our test apk.
include $(call all-makefiles-under,$(LOCAL_PATH))

2.编译

使用如下指令初始化指令环境

1
source build/envsetup.sh

然后使用mm或者mmm来编译即可。

1
2
3
4
5
6
7
8
- croot: Changes directory to the top of the tree.
- m: Makes from the top of the tree.
- mm: Builds all of the modules in the current directory.
- mmm: Builds all of the modules in the supplied directories.
- cgrep: Greps on all local C/C++ files.
- jgrep: Greps on all local Java files.
- resgrep: Greps on all local res/*.xml files.
- godir: Go to the directory containing a file.

mm是编译当前目录下的所有模块
mmm是编译指定目录的所有模块

1
2
3
4
5
//编译Launcher2模块
mmm packages/apps/Launcher2/

//编译当前目录下的模块
jackou@ubuntu:~/work_directory/pdk/apps/HelloWorld$ mm

因为我就在工程目录，就直接使用mm即可，可以看到提示了很多配置信息，其中最后一个OUT_DIR就是编译完成的app会放在out目录下。

mm

3.编译成功

我们可以看到最后一行编程成功，然后apk放在out/target/product…c/system/app/HelloWorld目录下。

编译完成

apk