使用Bazel构建Android应用

一、前提

  • Bazel
  • Android Studio
  • Git(可选)

二、开始

下载源码

git clone git@github.com:bazelbuild/examples.git bazel-examples
cd bazel-examples/android/tutorial

使用上述命令clone对应的工程源码,clone完成后,结构目录如下:

[min@localhost:] tutorial $ tree
.
├── README.md
└── src
    └── main
        ├── AndroidManifest.xml
        └── java
            └── com
                └── example
                    └── bazel
                        ├── AndroidManifest.xml
                        ├── Greeter.java
                        ├── MainActivity.java
                        └── res
                            ├── layout
                            │   └── activity_main.xml
                            └── values
                                ├── colors.xml
                                └── strings.xml

9 directories, 8 files

初始化工作空间

工作空间是一个包含了与一个或者多个工程源码的文件目录,在其根目录中存在一个WORKSPACE文件。

这个WORKSPACE文件可能为空,也有可能包含一些构建项目所需外部依赖的引用。在macOS或者Linux上,可以使用touch WORKSPACE创建一个空的WORKSPACE文件。

当创建完成WORKSPACE文件后,可以使用如下命令,检查Bazel是否准备妥当:

 bazel info workspace

如果Bazel输出当前目录当路径,即表示配置正确,示例如下:

[min@bogon:] tutorial $ bazel info workspace
/Users/min/Desktop/workspace/android/min/bazel-examples/android/tutorial

配置工具链

大体也能想到使用Bazel去编译Android App,实际上还是离不开Android SDK Build Tools,部分场景可能还需要Android NDK,所以Bazel需要一个可以配置Android SDK等工具链Path的地方,这就是上面提到的WORKSPACE文件的作用之一。

我们需要在WORKSPACE文件中添加如下两行内容:

# 配置Android SDK
android_sdk_repository(name = "androidsdk")

# 配置Android NDK(可选)
android_ndk_repository(name = "androidndk")

当然这其实是一种“简写”,因为Bazel会自动读取ANDROID_HOME, ANDROID_NDK_HOME环境变量,然后自动完成配置,完整版本应该是这个样子的,以Android SDK为例:

android_sdk_repository(
    name = "androidsdk",
    path = "/path/to/Android/sdk",
    api_level = 25,
    build_tools_version = "26.0.1"
)

Bazel只会识别ANDROID_HOME, ANDROID_NDK_HOME这两个环境变量,所以如果你的Path不是这样配置的,建议就可以使用完整版本配置或者更换Env名称。

创建构建文件

其实任何编译系统都需要一个来描述编译规则的文件,比如build.gradle、CMakeLists.txt等等,Bazel也不例外,它是一个叫做BUILD的文件,这个文件可以将Android的各类编译中间产物的关系进行进行描述,比如aapt编译出来的资源文件、javac编译出来的class文件等等,其使用Starlark语言编写,具体见Bazel 官网

针对Android,Bazel提供两个基础的编译规则:android_libraryandroid_binary,具体的含义如下:

  • android_library:声明一个Android library module;
  • android_binary:声明一个Android App;

创建android_library BUILD

src/main/java/com/example/bazel目录创建一个BUILD文件,并将如下内容添加进来:

# src/main/java/com/example/bazel/BUILD

package(
    default_visibility = ["//src:__subpackages__"],
)

android_library(
    name = "greeter_activity",
    srcs = [
        "Greeter.java",
        "MainActivity.java",
    ],
    manifest = "AndroidManifest.xml",
    resource_files = glob(["res/**"]),
)

创建android_binary BUILD

src/main目录下创建一个BUILD文件,并将如下内容添加进来:

# src/main/BUILD

android_binary(
    name = "app",
    manifest = "AndroidManifest.xml",
    deps = ["//src/main/java/com/example/bazel:greeter_activity"],
)

可以看到它依赖了上面android_library定义出来的greeter_activity

至此,我们的配置工作就完成了。

构建APP

在当前目录下执行如下构建命令:

tutorial $ bazel build //src/main:app

最后得出如下图所示结果 (目标APK路径:bazel-bin/src/main/app.apk):

编译结果

首次执行可能时间会比较长一些

安装执行

关于这部分,Bazel给出了一个完整的流程,你可以使用如下命令进行安装:

bazel mobile-install //src/main:app

备注:如果手机上没有GMS套件,建议还是使用adb install的方式,因为笔者在尝试的过程中发现,这种方式安装后,貌似Bazel会对.apk进行修改,导致导致Activity在启动时回去加载某个com.google.**.Stub*的类。

三、总结

  • 安装相关工具,准备工程源码;
  • 初始化工作空间,在WORKSPACE中配置相关工具链,比如Android SDK、Android NDK等;
  • 创建BUILD文件,并配置响应的编译规则,主要为android_libraryandroid_binary
  • 开始构建;

四、参考

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 225,271评论 6 524
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 96,533评论 3 405
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 172,580评论 0 370
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 61,203评论 1 303
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 70,204评论 6 401
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 53,664评论 1 316
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 42,014评论 3 431
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 40,991评论 0 280
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 47,536评论 1 326
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 39,558评论 3 347
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 41,678评论 1 355
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 37,267评论 5 351
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 42,997评论 3 341
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 33,429评论 0 25
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 34,580评论 1 277
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 50,259评论 3 382
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 46,744评论 2 366

推荐阅读更多精彩内容