[bazel]-bazel的使用

Change log

目录

[bazel]-导读
[bazel]-概念和术语
[bazel]-bazel的使用
[bazel]-tulsi的使用
[bazel]-如何编译
[bazel]-缓存
[bazel]-影响缓存命中的因素
[bazel]-优化
项目地址

一.是什么

bazel原理: http://www.cnblogs.com/Jack47/p/build-in-the-cloud.html

bazel官网: https://docs.bazel.build/versions/master/bazel-overview.html

二.安装

官网有安装教程.提供了三种安装方式.下面的homebrew是其中一种安装方式.

step1: install the JDK

Download the JDK from Oracle's JDK Page. Look for "macOS" under "Java SE Development Kit" and download JDK version 8.

step2: 通过homebrew安装bazel (需要先安装homebrew)

// 安装bazel
brew install bazel

// 查看bazel版本
bazel version

// 升级bazel
brew upgrade bazel

三.怎么用

bazel其实就是帮你做点击Xcode Run的时候做的事情.

官网安装步骤:https://docs.bazel.build/versions/master/tutorial/ios-app.html

以下只是结合实践并翻译官方文档而已.

step1: Create a WORKSPACE file

创建GXShell壳文件夹.
在GXShell文件夹下创建WORKSPACE文件

1.每个工作控件必须有一个命名为WORKSPACE的文件
2.并且需在根目录下.

目录如下:

image.png

step2: Update the WORKSPACE file

在WORKSPACE文件里我们需要依赖rules_apple和bazel-skylib两个包

rules_apple: 作用是帮你编译苹果设备的软件.最好依赖他的最新Tag
在这里查看最新Tag号: https://github.com/bazelbuild/rules_apple/releases

bazel-skylib: 作用是帮你管理你的源文件
在这里查看最新Tag号: https://github.com/bazelbuild/bazel-skylib/releases

在WORKSPACE里添加依赖的代码如下:

load('@bazel_tools//tools/build_defs/repo:git.bzl', 'git_repository')

git_repository(
    name = "build_bazel_rules_apple",
    remote = "https://github.com/bazelbuild/rules_apple.git",
    tag = "0.6.0",
)

load(
    "@build_bazel_rules_apple//apple:repositories.bzl",
    "apple_rules_dependencies",
)

apple_rules_dependencies()

git_repository(
    name = "bazel_skylib",
    remote = "https://github.com/bazelbuild/bazel-skylib.git",
    tag = "0.5.0",
)

step3: Create the source files

在GXShell文件夹里创建universal文件夹.
相当于使用Xcode创建新项目时自动帮你创建的Target文件夹.
而且Xcode还自动帮你创建了main.m AppDelegate.h/AppDelegate.m等源文件.
现在这些都需要我们手动创建了.

image.png

可以先通过Xcode创建一个新工程.然后把这几个文件复制过来.
问题一: Info.plist文件里必须指定Localization native development region.随便改成什么.因为是面向国内的APP.所以我改为China.
问题二: 这里因为我没使用Main.storyboard.所以需要在Info.plist文件里将Main.storyboard这一选项删除.

step4: Create a BUILD file

在bazel眼里.所有的target或者静态库都是独立的.
那么也就是说所有的target或者静态库都需要有一个BUILD文件来管理.
以此来告诉bazel他应该如果编译你的源文件.
所以我们需要在universal这个target下创建一个管理universal的BUILD文件.

image.png

step5: Add the rule load statement

在universal下的BUILD文件添加如下规则.
这段代码其实就是个声明.
告诉bazel需要用build_bazel_rulers_apple这个库里的那个规则来编译universal这个Target.

load("@build_bazel_rules_apple//apple:ios.bzl", "ios_application")

step6: Add an objc_library rule

继续在universal下的BUILD文件添加如下规则
这个objc_library是告诉bazel以下三件事情

1.name >> universal这个Target被编译成静态库后叫什么名字.
2.srcs >> universal这个target下哪些源文件需要被编译.我这里使用通配符.即universal文件夹下所有.h/.m都需要被编译.
3.hdrs >> universal这个taget哪些头文件是public

load("@build_bazel_rules_apple//apple:ios.bzl", "ios_application")

objc_library(
    name = "universal_lib",
    srcs = [
        "universal/main.m",
        "universal/AppDelegate.m",
        "universal/ViewController.m",
    ],
    hdrs = [
        "universal/AppDelegate.h",
        "universal/ViewController.h",
    ],
    enable_modules = 1,
)

step7: Add an ios_application rule

继续在universal下的BUILD文件添加如下规则

load("@build_bazel_rules_apple//apple:ios.bzl", "ios_application")

objc_library(
    name = "universal_lib",
    srcs = [
        "universal/main.m",
        "universal/AppDelegate.m",
        "universal/ViewController.m",
    ],
    hdrs = [
        "universal/AppDelegate.h",
        "universal/ViewController.h",
    ],
    enable_modules = 1,
)

ios_application(
    name = "universal",
    bundle_id = "com.sunxxxx.universal",
    families = [
        "iphone",
        "ipad",
    ],
    minimum_os_version = "9.0",
    infoplists = [":universal/Info.plist"],
    visibility = ["//visibility:public"],
    deps = [
        ":universal_lib"
    ],
)

这个ios_application是告诉bazel一下7件事

1.name >> 你app的名字

2.bundle_id >> app的唯一标识符

3.familier >> 支持iphone还是ipad还是都支持

4.munimum_os_version >> 最低支持的系统版本

5.infoplists >> info.plist文件路径

6.visibility >> 该库对其他库是否可见

7.deps >> 你依赖的静态库名字

step8: Build the app for the simulator

最后一步.使用bazel build命令编译你的app
然后bazel会生成ipa包在bazel-bin/universal/xx.ipa
然后你就可以拿着这个ipa包安装到device上了.

image.png

附录一:

问题:
apple_binary：'apple_binary'规则中没有这样的属性'non_propagated_deps'

我的BUILD文件中并没有任何此类属性。

image.png

apple_binary支持的所有属性: https://docs.bazel.build/versions/master/be/objective-c.html#apple_binary

在bazel的0.15版本non_propagated_deps这个属性被删除了.而我的bazel版本为0.15.2

image.png

解决办法:

需要升级Apple规则。在新的Bazel版本下但是使用的rulers_apple是旧的就会报这个错.
需要将rulers_apple升级到了0.6.0

下一篇：[bazel]-tulsi的使用