Flutter-OH三方库适配代码提交指南

Flutter-OH三方库适配代码提交指南

欢迎大家加入跨平台开发者社区

本文档旨在指导开发者在完成 Flutter 三方库的 OpenHarmony 适配后，如何规范地提交代码。请遵循以下步骤操作，以确保提交的代码清晰、合规，并避免将个人开发环境的敏感签名信息上传至代码仓库。

整体流程概述

代码提交主要包含三个步骤：1. 添加核心适配文件；2. 签署并提交代码；3. 推送至远程仓库。

详细操作步骤

1. 添加核心适配文件
   请使用以下命令，仅添加为 OpenHarmony 适配而新增或修改的关键文件：

   gitaddohos/ example/ohos/ pubspec.yaml README.OpenHarmony.md README.OpenHarmony_CN.md

2. 签署并提交代码
   使用-s参数签署贡献者声明，并规范填写提交信息：

   gitcommit -s -m “适配 flutter_native_timezone 至 Flutter-OH3.35.7”

   提交信息格式：适配 + [库名] + 至 Flutter-OH [版本号]

3. 推送至远程仓库

   gitpush

重要注意事项

在提交前，必须检查并清理example/ohos/build-profile.json5文件中的个人签名配置，以防止敏感信息泄露。

请进行如下修改：

• 提交前，清空signingConfigs配置节：

  "signingConfigs": [ ],

• 切勿提交包含个人签名材料的配置：(如下所示内容)

  "signingConfigs": [ { "name": "default", "type": "HarmonyOS", "material": { // 注意：以下为示例路径及虚构的密码，实际内容为您的个人开发环境配置，务必删除。 "certpath": "/Users/yourname/.ohos/config/your_cert.cer", "keyAlias": "debugKey", "keyPassword": "your_key_password", "profile": "/Users/yourname/.ohos/config/your_profile.p7b", "signAlg": "SHA256withECDSA", "storeFile": "/Users/yourname/.ohos/config/your_store.p12", "storePassword": "your_store_password" } } ],

总结

遵循以上步骤，即可正确、安全地完成适配代码的提交工作。核心在于：规范提交信息、清理敏感配置。