Bazel教程:构建iOS应用
本教程包含以下步骤(Bazel新用户请先参考: Bazel入门教程):
- 代码预览
- 创建BUILD构建文件
- 针对模拟器构建应用
- 查看构建输出
- 在模拟器环境运行/调试应用
- 针对设备构建应用
- 安装应用到设备
需要在 Mac OS X 环境,WORKSPACE
不用配置。
查看源文件结构
iOS应用源文件在$WORKSPACE/ios-app/UrlGet
目录。
代码在这里:https://github.com/bazelbuild/examples/tree/master/tutorial/ios-app/UrlGet
创建BUILD文件
在命令行用vi创建并编辑BUILD文件(其它编辑器也可以):
$ vi $WORKSPACE/ios-app/BUILD
添加一个objc_library
规则
Bazel针对构建iOS应用提供了诸多规则命令。在这里,我们首先使用 objc_library
规则从源文件和Xib文件构建 静态库。 (这个只是最小的规则,此外还有ios_application
规则可以用于构建多架构的iOS应用。)
BUILD的内容如下:
objc_library(
name = "UrlGetClasses",
srcs = [
"UrlGet/AppDelegate.m",
"UrlGet/UrlGetViewController.m",
],
hdrs = glob(["UrlGet/*.h"]),
xibs = ["UrlGet/UrlGetViewController.xib"],
)
规则对应的目标名字是UrlGetClasses
。
添加objc_binary
规则
objc_binary
创建一个 bundled应用中的二进制可执行程序。
BUILD文件添加如下内容:
objc_binary(
name = "ios-app-binary",
srcs = [
"UrlGet/main.m",
],
deps = [
":UrlGetClasses",
],
)
其中deps
属性引用了前面的UrlGetClasses
静态库。
添加ios_application
规则
ios_application
规则用于创建.ipa
打包应用, 同时生成Xcode过程文件。
BUILD文件添加如下内容:
ios_application(
name = "ios-app",
binary = ":ios-app-binary",
infoplist = "UrlGet/UrlGet-Info.plist",
)
完整的BUILD文件在这里:https://github.com/bazelbuild/examples/blob/master/tutorial/ios-app/BUILD
构建模拟器环境的应用
命令行环境,确保当前目录对应Bazel的workspace:
$ cd $WORKSPACE
输入以下命令构建应用:
$ bazel build //ios-app:ios-app
Bazel将启动构建工作。当构建完成时,输出类似下面的信息:
INFO: Found 1 target...
Target //ios-app:ios-app up-to-date:
bazel-bin/ios-app/ios-app.ipa
bazel-bin/ios-app/ios-app.xcodeproj/project.pbxproj
INFO: Elapsed time: 3.765s, Critical Path: 3.44s
查找构建的输出
输出的.ipa
和其它文件在$WORKSPACE/bazel-bin/ios-app
目录。
模拟器环境运行/调试应用
现在可以从Xcode环境的模拟器来运行应用。先打开$WORKSPACE/bazel-bin/ios-app/ios-app.xcodeproj
工程文件, 然后选择相应版本的iOS模拟器,然后点击 Run 按钮运行。
注意: 如果要Xcode工程中的任何信息发生变化(比如删除文件或添加/改变依赖),必须使用Bazel重新生成Xcode工程文件。
针对设备构建应用
针对设备构建应用,需要设置bazel以找到目标对应设备的provisioning profile配置文件。 根据以下步骤设置:
-
打开网页 Apple Profiles 下载设备对应的provisioning profile配置文件。 如果又疑问,请参考 Apple's documentation。
-
将profile配置文件放到
$WORKSPACE/tools/objc
目录。 -
可选操作 - 可以在
.gitignore
中忽略配置文件。 -
编辑
$WORKSPACE/tools/objc/BUILD
文件,添加:filegroup( name = "default_provisioning_profile", srcs = ["<NAME OF YOUR PROFILE>.mobileprovision"], )
现在可以构建针对设备的应用了:
$ bazel build //ios-app:ios-app --ios_multi_cpus=armv7,arm64
上面的命令将构建针对多个类型的设备应用。如果只需要构建真的特定类型的应用, 可以指定一个特定的设备架构体系结构。
如果需要选择一个特定版本的Xcode或特定版本的SDK,可以通过--xcode_version=7.2 --ios_sdk_version=9.2
指定。 要确保选定版本的SDK对应的Xcode已经安装到本机。
如果需要指定一个能够运行的最小iOS版本,可以通过--ios_minimum_os=7.0
指定。
安装应用到设备上
安装应用到设备最简单的方法是打开Xcode,然后点击Windows > Devices
菜单。 从左边列表选择相应的设备,点击 "+" 按钮并选择生成的 .ipa
文件。
如果程序没有运行,请检查设备和provisioning profile配置是否匹配。 点击Devices
下面的View Device Logs
按钮,可以查看到相关的错误信息。