GitCode 口袋工具部署与运行指南
本文介绍如何在 OpenHarmony 环境下部署并运行 GitCode 口袋工具,涵盖环境搭建、配置调整及调试运行全流程。
一、环境准备
确保本地开发环境满足以下要求:
- IDE:DevEco Studio 5.0+(需安装 OpenHarmony SDK 6.0.0 及以上)
- 框架:Flutter 环境(已配置
flutter build hap命令) - 设备:OpenHarmony 模拟器或真机(API 20 及以上)
提示:安装路径建议避免包含中文或特殊字符,以防构建时出现意外错误。
二、获取项目源码
为保证环境一致性,建议使用稳定版本的项目压缩包。下载后解压至本地目录,例如:
D:\HarmonyOS\gitcode_pocket_tool-v1.0.2
解压后的文件结构应包含以下关键文件夹:
flutter/- Flutter 主项目ohos/- HarmonyOS 原生层app_config/- 配置文件
推荐目录结构如下:
D:\
├── HarmonyOS\
│ ├── Projects\
│ │ └── gitcode_pocket_tool-v1.0.2\
│ └── SDK\
三、配置访问令牌
1. 生成 Token
登录 GitCode 平台,进入设置页面创建新的访问令牌。填写名称(如 flutter_harmony_token),勾选必要权限:
apiread_userread_repositoryread_organization
过期时间建议选择 90 天。生成后立即复制令牌字符串,关闭页面后将无法再次查看完整内容。
2. 安全建议
- 妥善保管令牌,切勿分享给他人。
- 建议定期更新令牌以保障安全。
四、修改 Dart 配置文件
使用 VS Code 打开解压目录下的 app_config 文件夹:
cd "D:\HarmonyOS\gitcode_pocket_tool-v1.0.2\app_config"
code .
找到 config.dart 文件,定位到 Token 定义处进行替换:
// config.dart
static const String gitCodeToken = 'your_copied_token_here';
// 替换为实际生成的令牌(保留单引号)
static const String gitCodeToken = 'glpat-xxxxxx_yyyyyyyyyyyyyyyy';
此外,还需检查 api_config.dart 和 token_config.dart 是否需要同步调整。
五、安装依赖包
在项目根目录(包含 ohos/ 和 的目录)中执行依赖安装:


