多终端工程创建与 AtomGit 代码提交全流程

核心任务

完成开源鸿蒙跨平台开发环境的验证，具体包括：

1. AtomGit 仓库建设：创建个人公开仓库并配置 SSH 密钥。
2. 多终端工程创建：基于 DevEco Studio 创建跨平台项目。
3. 多设备运行验证：在模拟器、真机或开发板上部署运行。
4. 代码提交与规范：将工程代码及运行凭证规范提交至 AtomGit。

---

一、AtomGit 远程仓库准备

1. 创建个人公开仓库

访问 AtomGit (GitCode) 官网并登录，点击右上角“新建项目”。

• 项目名称：建议使用英文，与项目内容对应（例如 HelloOpenHarmony）。
• 项目路径：自定义英文路径。
• 可见性：选择 公开。
• 初始化选项（可选）：
  • 勾选 README：项目说明文件。
  • 勾选 .gitignore：选择 Android 或 HarmonyOS 相关模板（后续可手动调整）。
  • 勾选 License：选择开源许可证（如 MIT License）。

2. 配置 SSH 密钥

为了安全且便捷地推送代码，需要配置 SSH 公钥。

1. 生成密钥对：在 Git Bash 或终端中执行：

   ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
   

   按回车键保持默认设置即可。

2. 获取公钥内容：
   找到生成的 .pub 文件（通常在 ~/.ssh/id_rsa.pub），复制全部内容。

3. 添加至 AtomGit：
   进入 AtomGit 个人设置 -> SSH 公钥，粘贴公钥并添加。

4. 验证连接：

   ssh -T git@gitcode.com
   

   若出现 Welcome to GitCode 字样，则配置成功。

二、本地工程搭建与初始化

1. 克隆仓库到本地

在本地合适的位置打开 Git Bash，执行克隆命令（地址在仓库首页获取）：

git clone https://gitcode.com/your_username/your_project.git

2. DevEco Studio 创建工程

1. 打开 DevEco Studio，选择 Create Project。
2. 选择模板：左侧选 Application，右侧选 Empty Ability，点击 Next。
3. 配置项目信息：
   • Project name：保持与仓库名一致或自定义。
   • Save location：关键步骤！ 请直接选择刚才克隆下来的仓库根目录（或者创建在仓库目录下，后续需移动文件）。建议直接指定到仓库文件夹内。
   • SDK 版本：选择 OpenHarmony 对应版本。

3. 配置 .gitignore

如果是新建的空文件夹可能没有 .gitignore，或者需要更新。确保忽略 IDE 生成的配置文件和构建产物。

# 进入仓库目录
cd your_project_folder
# 提交 .gitignore (如果已有修改)
git add .gitignore
git commit -m "feat: 添加 .gitignore 配置文件"
git push origin main

---

三、代码提交与同步

1. 提交代码与日志

在仓库根目录打开 Git Bash，执行以下标准提交流程：

# 1. 添加所有文件到暂存区（包含源码、配置文件、run_log.txt）
git add .

# 2. 本地提交
git commit -m "feat: 完成鸿蒙跨平台工程创建与多终端运行验证，新增日志与截图"

2. 推送至远程仓库

git push origin main

注意：踩坑提示
如果遇到 src refspec main does not match any 错误，可能是本地默认分支名为 master 而远程是 main。
解决方法：

git branch -m master main  # 重命名本地分支
git push -u origin main    # 重新推送并关联

---

四、验证与总结

1. 可复现性验证

为了确保提交的代码是完整的且“拿来即用”，建议进行独立验证：

1. 新建一个空的临时文件夹。
2. 执行 git clone 拉取刚才推送的代码。
3. 使用 DevEco Studio 打开该工程。
4. 直接运行，检查是否能在模拟器上正常启动且无报错。

2. 总结

通过 Day2 的实战，我们掌握了：

• ✅ 环境与工具：熟练使用 DevEco Studio 和 Git/AtomGit。
• ✅ 工程规范：理解了 .gitignore、README 的重要性以及分支管理。
• ✅ 全流程落地：打通了从“本地开发”到“云端托管”的完整链路。

---

欢迎加入开源鸿蒙跨平台社区： https://openharmonycrossplatform.csdn.net