「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@Componentstruct 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），供后续使用，username使用自己实际的用户名。

三、在本地初始化 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. 添加文件到暂存区并提交：- 将项目文件添加到暂存区：gitadd.- 提交更改：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- 添加更改：gitadd 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 - 项目实战：计数器应用