抱歉，该网页目前还不存在中文版本，请继续浏览其他网页！

编译Crosswalk

环境

  1. 请遵循Chromium wiki上面的步骤，搭建你的编译环境。

  2. 如果你打算编译Android平台的Crosswalk，则需要安装额外的编译依赖工具，参考页面编译Android平台的Chrome。

    下一小节 总结了包含的步骤。

  3. depot_tools 包含下列用于管理和编译Crosswalk的工具：

    • gclient 管理代码和依赖关系。
    • Ninja是一个在多数平台上推荐使用的用于编译Crosswalk的工具。 它的网站 包含了详细的使用说明。

代理设置

如果你在使用一个网络代理，那么你需要确保你的环境是否被正确地创建，以及变量设置是否合适。在Linux环境下，你至少需要做以下几步：

  1. 设置http_proxy和https_proxy环境变量:

     export http_proxy=http://example-host:port
 export https_proxy=http://example-host:port

  2. 在某处创建一个Boto配置文件，包含以下内容：

     [Boto]
 proxy = example-host
 proxy_port = port number

    然后, 将NO_AUTH_BOTO_CONFIG环境变量指向你创建的文件：

     export NO_AUTH_BOTO_CONFIG=/path/to/boto-file

下载Crosswalk源码

开始之前： Android

如果编译的是Android平台上的Crosswalk，你首先应该设置 XWALK_OS_ANDROID环境变量：

export XWALK_OS_ANDROID=1

你必须这样做，否则你下载的代码将不会包含某些对于Android环境下编译必要的组件。

如果你在下载源码时没有这个设置，你可以在之后设置并且再执行一次gclient sync，将其它的针对Android平台的组件包含进来。

获取源码

  1. 创建一个源码目录：

    cd <home directory>
mkdir crosswalk-src
cd crosswalk-src

  2. 自动生成gclient的配置文件(.gclient)：

    gclient config --name=src/xwalk \
  https://github.com/crosswalk-project/crosswalk.git

    你可以将https://替换成git://或者ssh://git@，依赖于你的代理需求和你是否想使用你的GitHub证书。

  3. 在包含.gclient文件的目录下，获取源码：

    gclient sync

追踪一个不同的Crosswalk分支

如果你想要追踪一个不是master的分支（例如beta或者一个稳定分支），你可以使用下面两种方式：

在初次checkout之前设定分支

如果你还没有Crosswalk的源代码，则将你需要checkout的分支的URL传递给gclient config调用。例如，为了追终crosswalk-2 branch:

gclient config --name=src/xwalk \
  git://github.com/crosswalk-project/crosswalk.git@origin/crosswalk-2

为一个已经存在的checkout改变分支

如果你已经克隆了一个Crosswalk，并且想改变追踪的分支，你需要新建一个git分支，然后编辑你的.gclient文件。

例如，假设你想要追踪crosswalk-2分支。 首先，在你的Crosswalk仓库中新建一个分支：

cd /path/to/src/xwalk
git checkout -b crosswalk-2 origin/crosswalk-2

然后，编辑你的.gclient文件（上面产生的）并且改变入口url。它看上去应该像这样：

"url": "git://github.com/crosswalk-project/crosswalk.git@origin/crosswalk-2",

然后，再次同步你的代码：

gclient sync

构建桌面版Crosswalk

下面这些步骤涵盖了编译Crosswalk的方方面面。编译的Crosswalk是运行在桌面环境(Windows, Linux,或Mac OS)下的。

  1. gyp是被用于生成Crosswalk项目的工具。这些项目随后会被用作实际代码编译的基础。

    为了编译项目，进入src目录并运行

    在Linux, Mac操作系统下：

    export GYP_GENERATORS='ninja'
python xwalk/gyp_xwalk

    在Windows下：

    set GYP_DEFINES=target_arch=x64
set GYP_GENERATORS=ninja
python xwalk\gyp_xwalk

    如果你想创建一个Visual Studio项目，以便使用Visual Studio下编译／编辑Crosswalk，你应该按如下方式设置GYP_GENERATORS：

    set GYP_GENERATORS=ninja,ninja-msvs

    注意：在Windows下，set在当前的cmd窗口下有效。setx使得在未来的cmd窗口下永久有效，类似于在环境变量对话框内设置变量。

  2. 现在你已经使用gyp构建了项目，并且已经准备实际编译。编译Crosswalk启动器（可以运行一个web应用）:

     ninja -C out/Release xwalk or ninja -C out/Release_x64 xwalk (on Windows)

测试桌面版Crosswalk

启动一个Crosswalk应用最简单的方式是使用一个应用的manifest作为参数的xwalk命令：

xwalk /path/to/manifest.json

Crosswalk将会解析manifest，并且从已经在start_url中定义好的入口处启动应用。

如果你没有任何的HTML应用来测试， Crosswalk样例中包含一些你可以试试。

编译Android版Crosswalk

如上面所提到的，Android平台的Crosswalk的编译过程主要基于Chrome的过程，所以需要确定你 对其很熟悉。

  1. 为Android平台的Crosswalk安装依赖关系：

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

    注意这个需要你的系统对apt-get的支持。 如果你的系统中没有apt-get (例如Fedora Linux)，下面的命令可以安装依赖：

    sudo yum install alsa-lib-devel alsa-lib-devel.i686 bison \
cairo-devel.i686 cups-devel cups-devel.i686 dbus-devel \
dbus-devel.i686 elfutils-libelf-devel.i686 elfutils-libelf-devel.x86_64 \
expat-devel expat-devel.i686 fontconfig-devel.i686 freetype-devel.i686 \
gcc-c++ gconf GConf2-devel GConf2-devel.i686 gconf-devel git \
glib2-devel.i686 glibc-devel.i686 gperf gtk2-devel harfbuzz-devel.i686 \
krb5-devel.i686 libcap-devel libcap-devel.i686 libcom_err-devel.i686 \
libgcrypt-devel libgcrypt-devel.i686 libgnome-keyring-devel \
libgpg-error-devel.i686 libgudev1-devel libpciaccess-devel \
libstdc++.i686 libX11-devel.i686  libXcomposite-devel.i686 \
libXcursor-devel.i686 libXdamage-devel.i686 libXext-devel.i686 \
libXfixes-devel.i686 libXi-devel.i686 libXrandr-devel.i686 \
libXrender-devel.i686 libXScrnSaver-devel libXtst-devel \
libXtst-devel.i686 lighttpd nss-devel nss.i686 pango-devel.i686 \
pciutils-devel pciutils-devel.i686 pulseaudio-libs-devel python-pexpect \
svn systemd-devel systemd-devel.i686 xorg-x11-server-Xvfb \
xorg-x11-utils zlib-devel.i686 zlib.i686

  2. 配置 gyp。

    gyp是在Chromium中使用的编译系统生成器，用于为Ninja和其他系统生成实际的编译文件。为了生成Android环境的编译文件还需要一些变量。

    在包含你的.gclient文件的目录下（在src/之上）生成一个名为chromium.gyp_env的文件。

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

    如果你需要编译ARM版，使用target_arch=arm代替上述的 target_arch=ia32。

  3. 配置setup来生成Crosswalk项目。

    export GYP_GENERATORS='ninja'
python xwalk/gyp_xwalk

  4. 通过工具和嵌入式库，编译Android版Crosswalk的主要部分，你可以运行：

    ninja -C out/Release xwalk_core_library

    这样将会在out/Release下创建一个名为xwalk_core_library的目录，目录中包含有特定平台（例如X86或者ARM版）的Crosswalk库，这些库可以将Crosswalk嵌入到项目中。

    编译Crosswalk的运行时库（在Crosswalk共享模式下，一个可以作为应用的runtime的APK），运行：

    ninja -C out/Release xwalk_runtime_lib_apk

    这将会在out/Release/apks下生成一个名称为XWalkRuntimeLib.apk的APK。

    为了构造一个简单的web应用APK（为了快速安装／目标测试），只要执行：

    ninja -C out/Release xwalk_app_template_apk

    这将会在out/Release/apks下生成一个名称为XWalkAppTemplate.apk的APK。

    最终，你也可以通过使用Gradle和Maven构建AAR文件。下列命令将会生成特定平台下的AAR文件，AAR文件包含了Crosswalk库。

    ninja -C out/Release xwalk_core_library_aar xwalk_shared_library_aar

    ARR文件都将位于out/Release目录下。

运行测试用例

如果你有兴趣运行Crosswalk的测试用例，你可以在src目录下编译测试用例：

ninja -C out/Release xwalk_unittest
ninja -C out/Release xwalk_browsertest

然后运行它们：

./out/Release/xwalk_unitttest
./out/Release/xwalk_browsertest