# huaweicloud-cloudPhone-aosp11 **Repository Path**: memcacheon/huaweicloud-cloudPhone-aosp11 ## Basic Information - **Project Name**: huaweicloud-cloudPhone-aosp11 - **Description**: 云手机AOSP11开源代码，用于构建运行在华为云手机服务器的Android11镜像 - **Primary Language**: Unknown - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 62 - **Created**: 2025-01-12 - **Last Updated**: 2025-02-13 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # [华为云手机开源项目仓主入口](https://gitee.com/HuaweiCloudDeveloper/huaweicloud-cloud-phone) # huaweicloud-cloudPhone-aosp11 #### 介绍 云手机AOSP11开源代码，用于构建运行在华为云手机服务器的Android11镜像 #### 软件架构 本软件基于AOSP 11.0.0_r48开发，支持修改以下路径中的源码 ``` aosp/frameworks aosp/packages aosp/vendor ``` #### 内容摘要 一 客户对接阶段 使用说明 1 申请权限 2 准备开发环境 二 客户日常修改代码编译构建阶段 使用说明 3. 修改代码 4. 配置脚本 5. 构建镜像 7. 版本管理 8. 与原仓库保持同步更新 三 客户定制化需求： 使用说明 6. 自定义系统签名 9. 定制webview 10. 提供预装华为应用 定制GMS：https://gitee.com/HuaweiCloudDeveloper/huaweicloud-cloudPhone-aosp11/wikis/%E5%AE%9A%E5%88%B6GMS%E9%95%9C%E5%83%8F 四 客户镜像管理： 支持镜像查询以及同region不同账号镜像共享 https://support.huaweicloud.com/api-cph/cph_api_0559.html #### 使用说明 ##### 1. 申请权限 请按照以下格式发送邮件，成功后可通过客户经理获取专属构建服务器地址和密钥 ``` 收件人： cphdeveloper@huawei.com 邮件标题： 申请AOSP11自定义镜像构建权限 邮件内容： 公司名称： 联系人： 联系电话： 客户经理： ``` ##### 2. 准备开发环境 建议使用Ubuntu 18.04，并安装curl，git，gpg等常用软件，确保开发环境可以联网 ##### 3. 修改代码 ###### 3.1 fork本仓库，本地修改代码 ``` 建议： 1. 在aosp/vendor/common/android 目录下放置新增的代码文件或者预编译产物 2. 在aosp/vendor/common/products/product_extra.mk 中声明构建规则 3. 如无特殊需求，不要修改aosp/vendor目录下的其他文件，否则可能会对镜像的基本功能造成影响 ``` ###### 3.2 提交代码，创建tag或branch + （必选）tag/branch即版本号，需满足命名规范，见`7.版本管理` + （可选）添加镜像构建账号 如果将代码仓设为私有，请将以下账户添加为只读成员，用于拉取代码和构建镜像 ``` cphdeveloper@huawei.com ``` 并咨询华为技术人员，在私有代码仓为cphdeveloper@huawei.com添加部署公钥 + （可选）本地编译验证 如需本地验证是否存在编译错误，可拉取原生AOSP代码后，复制本地代码到原生目录，执行以下命令进行验证 ``` lunch aosp_arm64-eng make framework -j ``` ##### 4. 配置脚本 修改build.sh，其中SERVER_ADDR和KEY为在`1.申请权限`步骤中获取的专属构建服务器地址和密钥 ``` BRANCH_TAG 代码的版本号，例如v1.2.1 KEY 专属构建密钥 IMG_NAME 自定义的镜像产物别名 IMG_UPLOAD_REGION 指定镜像上传region, 支持多region上传, 多个region间使用‘,’分隔 SERVER_ADDR 专属构建服务器 ``` ##### 5. 构建镜像 执行build.sh，支持以下参数 + 全量构建 会清理中间产物，速度较慢，建议生产环境使用。 ``` ./build.sh ``` + 增量构建 不清理中间产物，速度较快，建议仅用于调试阶段。 ``` ./build.sh -i ``` + 查看构建日志 如果构建失败，可通过日志找到错误，修正后重新触发构建。 ``` ./build.sh -l ``` 构建成功后，返回镜像ID ##### 6. 自定义系统签名 使用公共的系统签名有安全风险，可通过以下步骤制作私有系统签名，加密后上传，构建系统可保证私有的系统签名不会泄露。 ###### 6.1 制作私有系统签名 请参考 https://android.googlesource.com/platform/build/+/refs/tags/android-11.0.0_r48/target/product/security/README ###### 6.2 获取定位SDK的Key 系统网络定位和地理编码接口通过一个系统App，集成定位SDK开发实现，且和当前系统签名绑定 根据系统签名申请Key，请参考 https://lbs.amap.com/api/android-location-sdk/guide/create-project/get-key/ 系统App包名 ``` com.android.networklocation ``` 获取安全码SHA1 ``` keytool -printcert -file platform.x509.pem ``` 获取到Key后，将其保存至文件`amap_key`中构建镜像即可。如果更新了系统签名，更换镜像时需要重置手机才生效。 ###### 6.3 打包加密私有系统签名文件 完成以上步骤后，将生成的所有文件放入`security`文件夹，`security`文件夹应包含以下文件 ``` . |-- amap_key |-- media.pk8 |-- media.x509.pem |-- platform.pk8 |-- platform.x509.pem |-- releasekey.pk8 |-- releasekey.x509.pem |-- shared.pk8 |-- shared.x509.pem |-- testkey.pk8 |-- testkey.x509.pem |-- verity_key |-- veritykey.pk8 `-- veritykey.x509.pem ``` 依次执行以下命令完成打包： ``` cd security tar czvf security.tar.gz ./* ``` 下载并导入gpg公钥 ``` gpg --keyserver hkps://keyserver.ubuntu.com --recv-keys c5c7a35662a6f8080e27ab464a8e757d9b31879e ``` 并设置公钥信任等级为5 = I trust ultimate ``` gpg --edit-key C5C7A35662A6F8080E27AB464A8E757D9B31879E 5 ``` ctrl+D 退出gpg设置界面后执行 ``` gpg --recipient C5C7A35662A6F8080E27AB464A8E757D9B31879E --output security.tar.gz.gpg --encrypt security.tar.gz ``` ###### 6.4 上传私有系统签名文件 将加密后的私有系统签名文件包提交到代码仓的以下路径： ``` /aosp/vendor/common/android/security/security.tar.gz.gpg ``` ##### 7. 版本管理 本仓库使用tag进行版本管理。命名规则如下，可在本仓库的标签页查看所有tag，例如 ``` v1.0.0 v1.1.0 v1.2.0 ``` fork自本仓库的代码也必须创建tag，前两位必须与本仓库的tag保持一致，用来表示其对应关系，第三位可以设置为任意数字，例如 ``` v1.2.1 ``` 也支持使用branch方式替换tag ##### 8. 与原仓库保持同步更新 如果在fork代码后，本仓库的代码又发生了更新，可以使用以下方法同步原仓库的更新。 ###### 8.1 进入本地仓库目录 ###### 8.2 设置upstream仓库 ``` git remote add upstream git@gitee.com:HuaweiCloudDeveloper/huaweicloud-cloudPhone-aosp11.git ``` 设置后通过以下命令进行查看 ``` git remote -v ``` 显示以下两行表示设置成功 ``` upstream git@gitee.com:HuaweiCloudDeveloper/huaweicloud-cloudPhone-aosp11.git (fetch) upstream git@gitee.com:HuaweiCloudDeveloper/huaweicloud-cloudPhone-aosp11.git (push) ``` ###### 8.3 执行命令`git status`检查本地是否有未提交的修改。如果有，则把你本地的有效修改，先从本地仓库推送到你gitee的仓库。最后再执行一次`git status`检查本地已无未提交的修改。 ``` git add -A 或者 git add filename git commit -m "your note" git push origin master git status ``` ###### 8.4 抓取原仓库的指定tag ``` git pull upstream tag v1.2.0 ``` ###### 8.5 切换到master分支 ``` git checkout master ``` ###### 8.6 合并upstream的master分支 ``` git merge upstream/master ``` ###### 8.7 如有冲突，本地处理冲突后提交代码 ###### 8.8 创建tag ``` git tag -a v1.2.1 -m "update tag v1.2.1" ``` ###### 8.9 推送代码 ``` git push --tags ``` ##### 9. 定制webview：将准备好的webview.apk放在aosp/vendor/common/external/webview/webview.apk目录，文件名字固定为webview.apk ##### 10. 提供预装华为应用 本版本下预装的华为应用包括：华为浏览器、华为输入法、华为相机 您可通过修改aosp/vendor/common/products/product_extra.mk文件中的PRODUCT_PACKAGES字段进行修改 ``` PRODUCT_PACKAGES += \ HuaweiBrowser \ HuaweiHmsCore \ HuaweiInput \ OpenCamera ``` ##### 11. 镜像管理 支持镜像查询以及同region不同账号镜像共享 https://support.huaweicloud.com/api-cph/cph_api_0559.html 注意:同一个账号在同一个region下最多支持创建200个镜像文件