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: [email protected] (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的路径 -->
sudo xcode-select -switch /Applications/你的Xcode名称/Contents/Developer
7.2.2
解决方法:改变
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
本文版权所有,转载请说明出处