快速开始

项目地址：gitcode_pocket_tool:一个基于 Flutter 开发的 GitCode 搜索工具，支持搜索用户和仓库、本地登陆注册功能，提供流畅的分页加载体验。专为 OpenHarmony 平台优化，同时支持 Windows 等平台，帮助初学者快速入门。 - AtomGit | GitCodehttps://gitcode.com/YiXuanHQ/gitcode_pocket_tool

1. 克隆项目

git clone https://gitcode.com/YiXuanHQ/gitcode_pocket_tool.git
cd gitcode_pocket_tool

2. 拉取 OpenHarmony 适配依赖（flutter_packages）

如果你的工作区里没有 flutter_packages/ 目录，需要先拉取 OpenHarmony SIG 维护的适配仓库（shared_preferences_ohos 等依赖来自这里）：

Windows CMD（一行复制版）

git clone -b br_shared_preferences-v2.3.2_ohos https://gitee.com/openharmony-sig/flutter_packages.git flutter_packages

Windows PowerShell（一行复制版）

git clone -b br_shared_preferences-v2.3.2_ohos https://gitee.com/openharmony-sig/flutter_packages.git .\flutter_packages

3. 安装依赖

flutter pub get

4. 配置 Access Token

应用内的搜索功能需要 GitCode Access Token。

• 推荐方式：运行后在“搜索”页的 Token 输入框中粘贴你的 Access Token（支持显示/隐藏切换）。

• 可选方式（仅用于本地体验/调试）：在 lib/core/app_config.dart 中替换占位 Token：

static const demoToken = '<你的 GitCode 个人访问令牌>';

💡 获取 Access Token：登录 GitCode，进入个人设置 > Access Token，创建新的令牌。

步骤如下：

GitCode - 全球开发者的开源社区,开源代码托管平台https://gitcode.com/setting/token-classic

配置令牌名称和到期时间，之后向下滑找到新建访问令牌按钮，点击此按钮新建：

注意重要：新建成功后，一定要复制好这个访问令牌，并且保存好，不要让别人知道！

将复制的令牌替换下方<你的 GitCode 个人访问令牌>

5. 运行项目

• OpenHarmony（DevEco Studio）：使用 DevEco Studio 打开项目的 ohos/ 目录，点击右上角绿色运行按钮。

• Windows（命令行）：

flutter run -d windows

💡 提示：v1.0.4 起应用启动会先进行本地登录态校验；首次使用需要在登录页完成本地账号注册/登录后才会进入主界面。

6. 构建发布版本（可选）

# 构建 OpenHarmony 应用
cd ohos
npm install  # 首次需要安装依赖
cd entry
hvigorw assembleHap --mode module -p module=entry@default
​
# 构建 Windows 应用
flutter build windows --release

💡 提示：OpenHarmony 平台需要配置好开发环境，包括 DevEco Studio 和 HarmonyOS SDK。