Chromium Android编译指南

作者: hanpfei | 来源:发表于2016-08-03 12:26 被阅读6493次

    先决条件

    需要有一台装有Linux操作系统环境的主机来做编译,这个环境的搭建配置方法可以参考Linux-specific build instructions。目前还不支持在其它(Mac/Windows)平台上来为Android编译Chromium。

    获取代码

    首先需要下载并安装depot_tools包。在一个适当得目录下clone depot_tools包:

    $ git clone https://chromium.googlesource.com/chromium/tools/depot_tools.git
    

    然后修改.bashrc文件,将depot_tools的路径加进环境变量PATH中:

    export PATH=$PATH:/path/to/depot_tools
    

    如果从来没有下载过Chromium的代码的话,为源码创建一个文件夹并下载源码:

    mkdir ~/chromium && cd ~/chromium
    fetch --nohooks android # This will take 30 minutes on a fast connection
    

    如果之前下载过Linux版的Chromium代码,则可以通过给.gclient文件(在上面的源码根目录下,即~/chromium目录)附上target_os = ['android']来添加对Android的支持:

    cat > .gclient <<EOF
     solutions = [ ...existing stuff in here... ]
     target_os = [ 'android' ] # Add this to get Android stuff checked out.
    EOF
    

    执行gclient sync 来获取Android版的代码:

    gclient sync
    

    (可选)下载LKGR

    如果想编译某个良好状态下的Chromium,则可以同步LKGR(“last known good revision”)的代码。可以在这里找到它,还可以在这里找到最近的100个版本。然后运行:

    gclient sync --nohooks -r <lkgr-sha1>
    

    这不是一个典型的开发者工作流所需要的;而只是用于Chromium的一次性编译。

    为编译做配置

    Chromium的整个编译流程为:通过GYP或GN产生最终编译所需的ninja配置文件,然后由ninja根据产生的这些配置文件做编译。为Android编译Chromium可以通过GYP或GN来做配置,但GN增量编译最快,不久之后这也将成为唯一的编译配置方式。它们都是给Chromium的Android编译产生ninja文件的元构建系统。在构建瀑布中这两种构建都会被经常测试。

    GYP配置 (已废弃 -- 使用GN来代替)

    如果你在使用GYP,则在与.gclient位置相同的文件夹下,创建一个名为‘chromium.gyp_env’的文件,其中具有如下的内容:

    echo "{ 'GYP_DEFINES': 'OS=android target_arch=arm', }" > chromium.gyp_env
    

    注意, “arm”是默认的体系架构,它可以省略。如果是给x86或MIPS编译,则可以将target_arch改成“ia32”或“mipsel”。

    注意:如果在使用GYP_DEFINES环境变量,则它将覆盖这个文件中的设置。或者清除它,或者把它设置为上面的值,然后执行gclient runhooks

    参考 build/android/developer_recommended_flags.gypi 来了解其它建议的GYP设置。创建了chromium.gyp_env之后,你需要运行下面的命令来为gyp文件更新工程。你也需要在添加新的gyp文件、更新gyp文件或同步代码库时,再次执行这个命令。

    gclient runhooks
    

    这将下载更多东西,并提示你接受Terms of Service for Android SDK packages

    GN配置(建议采用)

    如果你使用GN,则创建一个编译目录,并通过如下命令设置编译标记:

    $ gn args out/Default
    

    直接执行这个命令会报错,比如:

    hanpfei0306@hanpfei0306:/media/data/Projects/OpenSource/chromium/src$ gn args out/Default
    gn.py: Could not find gn executable at: /media/data/Projects/OpenSource/chromium/src/buildtools/linux64/gn
    

    提示找不到chromium/src/buildtools/linux64/gn命令,如同GYP配置那样,需要执行 gclient runhooks

    可以选择out目录内其它的名字来替代out/Default。但不要使用GYP的out/Debug或out/Release,它们可能与GYP构建冲突。

    同时要知道某些脚本(比如tombstones.py,adb_gdb.py)需要设置CHROMIUM_OUTPUT_DIR=out/Default

    这个命令(gn args out/Default)将用GN构建参数文件启动编辑器。在这个文件中添加:

    target_os = "android"
    target_cpu = "arm"  # (default)
    is_debug = true  # (default)
    
    # Other args you may want to set:
    is_component_build = true
    is_clang = true
    symbol_level = 1  # Faster build with fewer symbols. -g1 rather than -g2
    enable_incremental_javac = true  # Much faster; experimental
    

    也可以指定target_cpu的值为“x86”和“mipsel”。以后可以在那个目录下重新运行gn args来编辑标记。参考GN构建配置来了解你可能想要设置的其它标记。

    这个命令启动系统默认的编辑器,创建chromium/src/out/Default/args.gn文件,并根据这个文件的内容来产生ninja文件。也就是在对这个文件做了修改,保存退出之后,gn会根据这个文件的内容来产生ninja文件。

    但这个文件本身不一定非要通过系统默认的编辑器来创建,也可以用任意一款自己用起来顺手的编辑器创建。只是在创建完了之后,需要再次运行gn args out/Default,然后保存直接退出,以便于让gn工具产生后续编译所需要的ninja文件。

    安装依赖

    通过如下的命令来更新编译所需的系统包:

    ./build/install-build-deps-android.sh
    

    还要确保OpenJDK 1.7被选为了默认得JDK:

    sudo update-alternatives --config javac
    sudo update-alternatives --config java
    sudo update-alternatives --config javaws
    sudo update-alternatives --config javap
    sudo update-alternatives --config jar
    sudo update-alternatives --config jarsigner
    

    同步子目录

    gclient sync
    

    编译

    模块编译,如:

    $ ninja -C out/Default/ net
    $ ninja -C out/Default/ url
    $ ninja -C out/Default/ zlib
    

    这将在chromium/src/out/Default下产生这些模块的BUILD.gn文件中定义得targets,比如net和url的共享库,zlib得静态库等。

    参考文档

    Android Build Instructions

    相关文章

      网友评论

      • Daniel_101:楼主你好!我下载了Chromium for Andriod 然后准备进行编译,遇到个问题。
        我在执行 gn gen --args='target_os="android"' out/Default 的时候, 返回错误信息“gn.py: Could not find gn executable at: /home/administrator/tools/chromium2/src/buildtools/linux64/gn” 这个信息和楼主提到的错误一样。我执行了gclient runhooks但还是报同样的错误。 请问楼主具体是怎么解决的 ?非常感谢!
      • 码上就说:執行 ninja -C out/Default/ cronet_java

        發生了如下問題:是因爲沒有配置cronet_java相關信息嗎?
        ninja: Entering directory `out/Default/'
        ninja: error: unknown target 'cronet_java', did you mean 'chrome_java'?
      • db8ef96192f1:楼主我之前报错Failed to connect to chromium.googlesource.com port 443: Operation timed out ,配置了 配置一下 git proxy 好了
        git config --global http.proxy 'socks5://127.0.0.1:1080'
        git config --global https.proxy 'socks5://127.0.0.1:1080'

        也报错Failed to connect to 127.0.0.1 port 1080: Connection refused,求解?
        hanpfei:你配置 git proxy 的时候,能确定代理服务器已经在对应的端口上运行起来了么?
        连不上 chromium.googlesource.com,可能是被墙了吧?直接在 /etc/hosts 里面加上这个域名的 IP 地址,或者弄个 VPN 试下。
      • 孤独狂饮:楼主,你编译后的 chrome webview 组建成功了吗?
        hanpfei:这个倒是没试过,官方提供的为 Android 编译系统 WebView 的文档位于 Build Instructions (Android WebView) https://www.chromium.org/developers/how-tos/build-instructions-android-webview ,有兴趣的话可以试下。
      • 8bf222c7dd04:请问,自己编译一个chromium,给自己的android app使用,可行吧?
        hanpfei:是要编译 chromium 的网络库呢, 还是要编译 chromium WebView呢?
        如果是网络库的话,我们有开源出来一个项目,[chromium-net](https://github.com/hanpfei/chromium-net),可以编译出来给自己的app使用。欢迎试用和star哈。

        如果是要编译 chromium webview的话,可以试一下[crosswalk](https://github.com/crosswalk-project/crosswalk)。
      • 巴图鲁:膜拜
      • 0106dc41aca3:我在Fedora中编译,执行到./build/install-build-deps-android.sh 这步时,报错了:
        ERROR: Only Ubuntu 12.04 (precise), 14.04 (trusty), 14.10 (utopic), 15.04 (vivid), 15.10 (wily) and 16.04 (xenial) are currently supported。
        现在只支持Ubuntu了吗?
        hanpfei:@xinglsh 我倒是没有在Fedora上编译过。
        ./build/install-build-deps-android.sh只是一个shell脚本吧,有兴趣的话可以看看源码,看看能不能修复一下这个脚本,来在Fedora上运行。
        不过最省事的当然是把Fedora换成Ubuntu了 :joy:
      • 8130566994ef:开了代理,还是会出现错误:Failed to connect to chromium.googlesource.com port 443: Operation timed out
        网页是可以打开的。不知道怎么解决
        8130566994ef:配置一下 git proxy 好了
        git config --global http.proxy 'socks5://127.0.0.1:1080'
        git config --global https.proxy 'socks5://127.0.0.1:1080'

      本文标题:Chromium Android编译指南

      本文链接:https://www.haomeiwen.com/subject/uxmqsttx.html