「Mac畅玩鸿蒙与硬件9」鸿蒙开发环境配置篇9 - 使用 Git 进行版本控制

在 HarmonyOS 项目开发中，Git 版本控制可以帮助开发者规范地管理代码变更，确保协作流程顺畅。本篇将详细介绍从创建项目、提交代码到 Git 远程仓库，再到修改、推送更新的完整操作流程，重点演示如何使用 Git 和 GitHub 进行身份验证和版本管理。

关键词

• 版本控制
• Git 基础操作
• 本地项目提交到 Git
• 文件修改与同步
• 使用 GitHub Personal Access Token (PAT) 认证

一、新建本地项目并运行 HelloWorld

1. 在 DevEco Studio 中创建新项目：

   • 打开 DevEco Studio，选择 File > New > Create Project。
   • 选择模板并填写项目名称（如 HelloWorld），创建项目后，项目结构将生成在 src/main/ets/pages/Index.ets 文件中。

2. 查看 Index.ets 初始代码：
   DevEco Studio 自动生成的 Index.ets 文件内容如下：

   @Entry
   @Component
   struct Index {
        
     @State message: string = 'Hello World';
   
     build() {
        
       RelativeContainer() {
        
         Text(this.message)
           .id('HelloWorld')
           .fontSize(50)
           .fontWeight(FontWeight.Bold)
           .alignRules({
        
             center: {
         anchor: '__container__', align: VerticalAlign.Center },
             middle: {
         anchor: '__container__', align: HorizontalAlign.Center }
           })
       }
       .height('100%')
       .width('100%')
     }
   }
   

3. 运行项目：

   • 选择模拟器或真实设备，点击 Run 按钮，确认屏幕中央显示“Hello World”。

二、在 GitHub 创建远程仓库

1. 创建仓库：
   • 登录 GitHub，点击右上角头像并选择 Your repositories。
   • 点击 New，输入仓库名称（如 HelloWorld），选择公开或私有，然后点击 Create repository。
   • 复制仓库的 HTTPS 地址（如 https://github.com/username/HelloWorld.git），供后续使用。

三、在本地初始化 Git 并关联远程仓库

1. 初始化本地 Git 仓库：

   • 打开终端并进入项目文件夹：

     cd /路径/到/HelloWorld
     

   • 初始化 Git 仓库：

     git init
     

   • 添加远程仓库地址：

     git remote add origin https://github.com/username/HelloWorld.git
     

2. 验证远程仓库连接：

   git remote -v
   

四、生成 GitHub Personal Access Token (PAT)

1. 生成 PAT：
   • 登录 GitHub，依次进入 Settings > Developer settings > Personal access tokens > Tokens (classic)。
   • 点击 Generate new token，设置名称，选择有效期和权限（至少勾选 repo 权限），然后点击 Generate token。
   • 复制并保存 token，页面刷新后将无法查看。

五、初次提交并推送项目到 GitHub

1. 添加文件到暂存区并提交：

   • 将项目文件添加到暂存区：

     git add .
     

   • 提交更改：

     git commit -m "初次提交：添加 HelloWorld 项目"
     

2. 推送代码到远程仓库：

   • 执行推送命令：

     git push -u origin main
     

   • 此时，Git 将提示输入 GitHub 用户名和密码。
     • Username：输入 GitHub 用户名。
     • Password：粘贴 Personal Access Token 作为密码。

3. 永久存储 PAT（可选）：

   • 如需免除每次推送时重复输入 PAT，可在首次推送后执行：

     git config --global credential.helper store
     

六、修改代码并再次提交到 GitHub

1. 修改 Index.ets 文件：

   • 将 message 变量内容从“Hello World”改为“Hello Harmony”：

     @State message: string = 'Hello Harmony';
     

2. 查看状态、添加和提交更改：

   • 查看状态：

     git status
     

   • 添加更改：

     git add entry/src/main/ets/pages/Index.ets
     

   • 提交更改：

     git commit -m "更新 message 变量内容"
     

3. 推送更新到远程仓库：

   git push
   

4. 确认更新：

   • 在 GitHub 页面中确认 Index.ets 文件内容已更新。

七、常用 Git 操作

1. 查看提交历史：

   git log --oneline
   

2. 回滚最近一次提交：

   • 如需撤销最近的提交（保留已修改内容）：

     git reset --soft HEAD~1
     

3. 同步远程更新：

   • 若有团队成员推送了更新，可以使用以下命令同步本地代码：

     git pull origin main
     

八、Git 提交最佳实践

• 使用描述性提交信息：如“修复主页布局问题”。
• 分阶段提交：按功能模块分阶段提交，便于追踪和回滚。
• 定期推送：减少协作中的冲突。

小结

本篇从项目创建到代码提交、推送至 GitHub，展示了使用 Git 进行版本控制的基本流程和 GitHub PAT 认证方式。通过 Git 版本控制，开发者可高效管理代码，提升协作效率，确保代码一致性和规范性。

下一篇预告

下一篇将带你完成一个小型实战项目：构建简单的计数器应用，帮助熟悉鸿蒙开发环境和组件操作。

上一篇：「Mac畅玩鸿蒙与硬件8」鸿蒙开发环境配置篇8 - 应用依赖与资源管理

下一篇：「Mac畅玩鸿蒙与硬件10」鸿蒙开发环境配置篇10 - 项目实战：计数器应用