Chromium for iOS 开发 + 上架

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为ReleaseDebug设备和模拟器构建创建四个适当配置的构建目录,并生成适当的Xcode workspaceout/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 identifierprovisioning 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.gnis_chrome_branded = false

7.3 打包后的格式仍为.app 且.app文件中发布证书可能错误,仍为开发者证书
解决方法:通过重签名方式替换证书 后转换为.ipa

Chromium官方文档(需翻墙)
https://chromium.googlesource.com/chromium/src/+/master/docs/ios/build_instructions.md

本文版权所有,转载请说明出处

你可能感兴趣的:(Chromium for iOS 开发 + 上架)