1.系统要求
运行10.12.6或更高版本的64位Mac。
Xcode 10.0+。
JDK的当前版本（Closure编译器所需）
2.安装depot_tools
2.1 下载depot_tools
$ git clone https://chromium.googlesource.com/chromium/tools/depot_tools.git
2.2 指定depot_tools的路径
$ export PATH="$PATH:/path/to/depot_tools"
PS:$ echo $PATH,检查是否有depot_tools的路径
3.下载Chromium源码
$ fetch ios
如果不想要完整的仓库历史记录，可以通过
$ fetch --no-history ios
来节省大量时间fetch。
中途断掉 继续同步
$ gclient sync
$ gclient sync --no-history
PS:下载代码需要花费很长时间 下完23G多
当fetch完成时，它会创建一个隐藏的.gclient文件和一个名为目录src在工作目录。
4.设置构建
4.1 进入src文件
$ cd src
4.2 运行 ios/build/tools/setup-gn.py
它将out为Release和Debug设备和模拟器构建创建四个适当配置的构建目录，并生成适当的Xcode workspace（out/build/all.xcworkspace）
4.3 使用Xcode或命令行构建ninja。
Xcode:command + r 或者点击run即可(构建+运行)
命令行:setup-gn.py创建的子目录名为out/${configuration}-${platform}，因此Debug对于模拟器使用的构建：
$ ninja -C out/Debug-iphonesimulator gn_all
PS:1.如果出现ninja: error: loading 'build.ninja': No such file or directory，请检查是否有多余空格
2.gn_all为构建app本身以及测试等所有文件 耗时较长
chrome为仅构建app本身 耗时较短
其他可通过查看targets中对应名称选择
3.setup-gn.py每次BUILD.gn更新一个文件（由你或在重新定位后）都需要运行脚本。如果忘记运行它，Xcode中的目标和文件列表可能是未更新前的。
5.真机运行(严格按照要求来，否则极大可能失败)
为了能够在设备上构建和运行Chromium，需要拥有Apple开发者帐号和相应的provisioning profiles，然后配置构建来使用它们
5.1 代码签名身份
有关如何获取代码签名身份和证书，请参阅Apple文档。可以通过运行以下命令来检查是否正确安装了代码签名标识。
$ security find-identity -v -p codesigning
运行结果:(如果有)
1) 0123456789ABCDEF0123456789ABCDEF01234567 "iPhone Developer: someone@example.com (XXXXXXXXXX)"
1 valid identities found
如果命令输出显示没有有效身份，那么就是没有安装代码签名标识，需要从Apple获取一个。
如果有多个标识，则构建系统可能会自动选择错误的标识，可以使用src/build/config/ios/ios_sdk.gni里的gn变量ios_code_signing_identity来设置使用哪个标识，例如
ios_code_signing_identity = "0123456789ABCDEF0123456789ABCDEF01234567"
5.2 设备provisioning profiles
获得代码签名标识后，确定应用程序包标识符的前缀。这由src/build/config/ios/ios_sdk.gni里的gn变量ios_app_bundle_id_prefix控制，默认值为"org.chromium"。
然后，向Apple请求以下为bundle identifier的provisioning profiles
${prefix}.chrome.ios.herebedragons
${prefix}.chrome.ios.herebedragons.ShareExtension
${prefix}.chrome.ios.herebedragons.TodayExtension
${prefix}.chrome.ios.herebedragons.SearchTodayExtension
${prefix}.chrome.ios.herebedragons.ContentTodayExtension
所有这些证书都需要com.apple.security.application-groups为以下组启用“App Groups”()功能：
group.${prefix}.chrome
group.${prefix}.common
group.${prefix}.chrome仅由Chromium及其扩展来共享文件和配置，
而group.${prefix}.common可与Chromium和来自同一组织的其他应用程序共享，可用于发送命令 到Chromium。
5.3 设备安装APP
由于构建生成的格式为.app，需要转换为.ipa才能在设备上安装
转换见:iOS .app格式转.ipa格式
PS:内部测试可使用fir.im或者蒲公英等内测托管平台
6.通过命令行运行APP(适用于模拟器)
要从命令行在模拟器中运行，可以使用iossim
$ out/Debug-iphonesimulator/iossim out/Debug-iphonesimulator/Chromium.app
使用Xcode 9及以上版本，iossim不再自动启动模拟器。现在必须在Xcode（Xcode > Open Developer Tool > Simulator）中手动启动，且必须在iossim执行后启动。
如果需要在指定的模拟器上运行，如在系统版本为10.0的iPhone 6s的模拟器上运行Chromium:
$ out/Debug-iphonesimulator/iossim -d 'iPhone 6s' -s '10.0' \
out/Debug-iphonesimulator/Chromium.app
PS:不要改动源码中info.plist中的Bundle identifier，会导致构建失败，改动后需要改回${IOS_BUNDLE_ID_PREFIX}.${CHROMIUM_BUNDLE_ID:rfc1034identifier}，其他参数也尽量不要改动
7.app上架 !!! -- Chromium官方文档未说明部分
7.1 打包正式版app (Xcode上打包Archive功能无法实现，仅能命令行)
命令行如下
$ ninja -C out/Official-iphoneos chrome
7.2 实现命令行时可能报的错误
7.2.1
xcode路径错误.png
解决方法：重新定位Xcode的路径 -->
sudo xcode-select -switch /Applications/你的Xcode名称/Contents/Developer
7.2.2
打包参数错误.png
解决方法：改变
src/out/Official-iphoneos/args.gn中is_chrome_branded = false
7.3 打包后的格式仍为.app 且.app文件中发布证书可能错误，仍为开发者证书
解决方法：通过重签名方式替换证书 后转换为.ipa
Chromium官方文档（需翻墙）
https://chromium.googlesource.com/chromium/src/+/master/docs/ios/build_instructions.md
本文版权所有，转载请说明出处
网友评论