Back to Details

openharmony-download

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

OpenHarmony Download Skill

OpenHarmony 源码下载 Skill

OpenHarmony 源码下载 Skill - 对话式信息收集 + 环境检查 + 前台实时下载。
OpenHarmony 源码下载 Skill - 对话式信息收集 + 环境检查 + 前台实时下载。

工作流程

工作流程

  1. 选择镜像源（AskUserQuestion 单选）
  2. 环境检查（逐项对话式检查，失败时引导解决）
  3. 选择分支（AskUserQuestion 单选）
  4. 选择目录（AskUserQuestion 单选）
  5. 执行下载（Bash 工具，前台实时输出）
  1. 选择镜像源（AskUserQuestion 单选）
  2. 环境检查（逐项对话式检查，失败时引导解决）
  3. 选择分支（AskUserQuestion 单选）
  4. 选择目录（AskUserQuestion 单选）
  5. 执行下载（Bash 工具，前台实时输出）

对话流程

对话流程

步骤 1：选择镜像源

步骤 1：选择镜像源

javascript
AskUserQuestion({
  questions: [{
    header: "镜像源",
    question: "请选择 OpenHarmony 镜像源",
    options: [
      { label: "GitCode", description: "推荐国内用户，速度最快" },
      { label: "Gitee", description: "国内用户" },
      { label: "GitHub", description: "国际用户" }
    ],
    multiSelect: false
  }]
})
javascript
AskUserQuestion({
  questions: [{
    header: "镜像源",
    question: "请选择 OpenHarmony 镜像源",
    options: [
      { label: "GitCode", description: "推荐国内用户，速度最快" },
      { label: "Gitee", description: "国内用户" },
      { label: "GitHub", description: "国际用户" }
    ],
    multiSelect: false
  }]
})

步骤 2：环境检查

步骤 2：环境检查

镜像源选择后，使用 Bash 工具逐项检查环境：
javascript
Bash({ command: "bash scripts/check_env.sh git", description: "Check git installation" })
Bash({ command: "bash scripts/check_env.sh git-lfs", description: "Check git-lfs installation" })
Bash({ command: "bash scripts/check_env.sh python3", description: "Check python3 installation" })
Bash({ command: "bash scripts/check_env.sh curl", description: "Check curl installation" })
Bash({ command: "bash scripts/check_env.sh repo", description: "Check repo installation" })
Bash({ command: "bash scripts/check_env.sh git-config", description: "Check git configuration" })
Bash({ command: "bash scripts/check_env.sh disk-space", description: "Check available disk space" })
检查失败时：显示错误 + 提供安装命令 + 等待用户修复 + 重新检查
常用安装命令：
  • git: 
    sudo apt-get install git
    (Ubuntu/Debian)
  • git-lfs: 
    sudo apt-get install git-lfs && git lfs install
  • repo: 见脚本输出的安装指引
  • Git 配置: 
    git config --global user.name "Your Name" && git config --global user.email "your-email@example.com"
镜像源选择后，使用 Bash 工具逐项检查环境：
javascript
Bash({ command: "bash scripts/check_env.sh git", description: "检查Git安装情况" })
Bash({ command: "bash scripts/check_env.sh git-lfs", description: "检查git-lfs安装情况" })
Bash({ command: "bash scripts/check_env.sh python3", description: "检查Python3安装情况" })
Bash({ command: "bash scripts/check_env.sh curl", description: "检查curl安装情况" })
Bash({ command: "bash scripts/check_env.sh repo", description: "检查Repo安装情况" })
Bash({ command: "bash scripts/check_env.sh git-config", description: "检查Git配置情况" })
Bash({ command: "bash scripts/check_env.sh disk-space", description: "检查可用磁盘空间" })
检查失败时：显示错误 + 提供安装命令 + 等待用户修复 + 重新检查
常用安装命令：
  • git: 
    sudo apt-get install git
    (Ubuntu/Debian)
  • git-lfs: 
    sudo apt-get install git-lfs && git lfs install
  • repo: 见脚本输出的安装指引
  • Git 配置: 
    git config --global user.name "Your Name" && git config --global user.email "your-email@example.com"

步骤 3：选择分支

步骤 3：选择分支

javascript
AskUserQuestion({
  questions: [{
    header: "分支",
    question: "请选择 OpenHarmony 分支",
    options: [
      { label: "master", description: "主分支（最新开发代码）" },
      { label: "OpenHarmony-5.1.0-Release", description: "5.1.0 版本" },
      { label: "OpenHarmony-5.0.3-Release", description: "5.0.3 版本" },
      { label: "OpenHarmony-5.0.2-Release", description: "5.0.2 版本" },
      { label: "OpenHarmony-5.0.1-Release", description: "5.0.1 版本" },
      { label: "OpenHarmony-4.1-Release", description: "4.1 版本" },
      { label: "自定义分支", description: "输入自定义分支名" }
    ],
    multiSelect: false
  }]
})
javascript
AskUserQuestion({
  questions: [{
    header: "分支",
    question: "请选择 OpenHarmony 分支",
    options: [
      { label: "master", description: "主分支（最新开发代码）" },
      { label: "OpenHarmony-5.1.0-Release", description: "5.1.0 版本" },
      { label: "OpenHarmony-5.0.3-Release", description: "5.0.3 版本" },
      { label: "OpenHarmony-5.0.2-Release", description: "5.0.2 版本" },
      { label: "OpenHarmony-5.0.1-Release", description: "5.0.1 版本" },
      { label: "OpenHarmony-4.1-Release", description: "4.1 版本" },
      { label: "自定义分支", description: "输入自定义分支名" }
    ],
    multiSelect: false
  }]
})

步骤 4：选择目录

步骤 4：选择目录

javascript
AskUserQuestion({
  questions: [{
    header: "目录",
    question: "请选择下载目录",
    options: [
      { label: "默认位置", description: "~/OpenHarmony/[branch]/" },
      { label: "自定义路径", description: "指定其他位置" }
    ],
    multiSelect: false
  }]
})
javascript
AskUserQuestion({
  questions: [{
    header: "目录",
    question: "请选择下载目录",
    options: [
      { label: "默认位置", description: "~/OpenHarmony/[branch]/" },
      { label: "自定义路径", description: "指定其他位置" }
    ],
    multiSelect: false
  }]
})

步骤 5：确认并执行下载

步骤 5：确认并执行下载

显示配置摘要，使用 AskUserQuestion 确认是否开始：
javascript
// 显示配置摘要
Claude: 好的，准备下载 OpenHarmony 源码：

配置摘要:
- 镜像源: ${MIRROR}
- 分支: ${BRANCH}
- 目录: ${DOWNLOAD_DIR}
- 并行任务: CPU核心数/4（自动计算）

下载将在前台运行，进度实时显示。
这将需要 30 分钟到数小时。

AskUserQuestion({
  questions: [{
    header: "确认",
    question: "是否开始下载？",
    options: [
      { label: "开始下载", description: "立即开始下载 OpenHarmony 源码" },
      { label: "返回重新配置", description: "返回步骤1，重新选择配置" }
    ],
    multiSelect: false
  }]
})
如果选择"开始下载"：
使用 Bash 工具执行下载脚本，传入用户选择的镜像源、分支和目录参数：
javascript
Bash({
  command: `bash scripts/download_openharmony.sh -m ${MIRROR} -b ${BRANCH} ${CUSTOM_DIR ? `-d ${CUSTOM_DIR}` : ''}`,
  description: `Download OpenHarmony ${BRANCH} from ${MIRROR}`
})
下载将在前台运行，进度实时显示。
如果选择"返回重新配置"： 返回步骤1，重新选择镜像源、分支、目录。
显示配置摘要，使用 AskUserQuestion 确认是否开始：
javascript
// 显示配置摘要
Claude: 好的，准备下载 OpenHarmony 源码：

配置摘要:
- 镜像源: ${MIRROR}
- 分支: ${BRANCH}
- 目录: ${DOWNLOAD_DIR}
- 并行任务: CPU核心数/4（自动计算）

下载将在前台运行，进度实时显示。
这将需要 30 分钟到数小时。

AskUserQuestion({
  questions: [{
    header: "确认",
    question: "是否开始下载？",
    options: [
      { label: "开始下载", description: "立即开始下载 OpenHarmony 源码" },
      { label: "返回重新配置", description: "返回步骤1，重新选择配置" }
    ],
    multiSelect: false
  }]
})
如果选择"开始下载"：
使用 Bash 工具执行下载脚本，传入用户选择的镜像源、分支和目录参数：
javascript
Bash({
  command: `bash scripts/download_openharmony.sh -m ${MIRROR} -b ${BRANCH} ${CUSTOM_DIR ? `-d ${CUSTOM_DIR}` : ''}`,
  description: `从${MIRROR}下载OpenHarmony ${BRANCH}分支`
})
下载将在前台运行，进度实时显示。
如果选择"返回重新配置"： 返回步骤1，重新选择镜像源、分支、目录。

脚本说明

脚本说明

download_openharmony.sh

download_openharmony.sh

bash
必需参数:
  -m MIRROR    镜像源（gitcode|gitee|github）
  -b BRANCH    分支名

可选参数:
  -d DIR       下载目录（绝对路径）
  -j JOBS      并行任务数（默认: CPU核心数/4）
bash
必需参数:
  -m MIRROR    镜像源（gitcode|gitee|github）
  -b BRANCH    分支名

可选参数:
  -d DIR       下载目录（绝对路径）
  -j JOBS      并行任务数（默认: CPU核心数/4）

check_env.sh

check_env.sh

bash
用法: check_env.sh <check_type>

检查类型: git | git-lfs | python3 | curl | repo | git-config | disk-space | all
bash
用法: check_env.sh <check_type>

检查类型: git | git-lfs | python3 | curl | repo | git-config | disk-space | all

verify_download.sh

verify_download.sh

自动验证下载完整性（下载脚本自动调用）：
  • 目录结构检查
  • foundation 子系统检查
  • ACE Engine 组件检查
  • 关键文件检查
  • repo 状态检查
  • 仓库完整性验证
自动验证下载完整性（下载脚本自动调用）：
  • 目录结构检查
  • foundation 子系统检查
  • ACE Engine 组件检查
  • 关键文件检查
  • repo 状态检查
  • 仓库完整性验证

验证结果处理

验证结果处理

验证通过

验证通过

✓ 验证通过！OpenHarmony 源码完整。

后续步骤:
1. 配置编译环境
2. 全量编译代码: ./build.sh --ccache --product-name rk3568
✓ 验证通过！OpenHarmony 源码完整。

后续步骤:
1. 配置编译环境
2. 全量编译代码: ./build.sh --ccache --product-name rk3568

验证失败

验证失败

✗ 验证发现问题

建议:
1. 同步缺失仓库: repo sync -c
2. 拉取 LFS 文件: repo forall -c 'git lfs pull'
3. 检查网络连接
✗ 验证发现问题

建议:
1. 同步缺失仓库: repo sync -c
2. 拉取 LFS 文件: repo forall -c 'git lfs pull'
3. 检查网络连接