# 原始碼獲取
詳情請參考：[https://gitee.com/openharmony/docs/blob/master/get-code/%E6%BA%90%E7%A0%81%E8%8E%B7%E5%8F%96.md](https://gitee.com/openharmony/docs/blob/master/get-code/%E6%BA%90%E7%A0%81%E8%8E%B7%E5%8F%96.md)

# OpenHarmony介紹
  OpenHarmony是HarmonyOS的開源版，由華為捐贈給開放原子開源基金會（OpenAtom Foundation）開源。第一個開源版本支援在128KB~128MB裝置上執行，歡迎參加開源社群一起持續演進。

程式碼倉庫地址：[https://openharmony.gitee.com](https://openharmony.gitee.com)

# 原始碼獲取概述
  本文件將介紹如何獲取OpenHarmony原始碼並說明OpenHarmony的原始碼目錄結構。OpenHarmony的程式碼以元件的形式開放，開發者可以透過如下其中一種方式獲取：

- **獲取方式1：** 從映象站點下載壓縮檔案（推薦）
 - **獲取方式2：** 從hpm網站元件式獲取。透過HPM，查詢滿足需求的解決方案，挑選/裁剪元件後下載。
 - **獲取方式3：** 用包管理器命令列工具獲取。透過HPM的hpm-cli命令列工具，執行命令下載。
 - **獲取方式4：** 從程式碼倉庫獲取。透過repo或git工具從程式碼倉庫中下載。

# 獲取方式1：從映象站點獲取
  為了獲得更好的下載效能，您可以選擇從以下站點的映象庫獲取原始碼或者對應的解決方案。

**表 1** 原始碼獲取路徑

# 獲取方式2：從hpm網站元件式獲取
## 適用場景
  對於剛接觸OpenHarmony的新使用者，希望能夠參考一些示例解決方案從而進行快速開發。可以在HPM獲取推薦的解決方案，以此為基礎，增加或裁剪部分元件，快速定製系統。

## 操作步驟

1. **查詢合適的解決方案元件包。**
 - 開啟包管理頁面HPM，設定搜尋的物件為“解決方案“，如下圖所示。
 - 自搜尋框輸入關鍵字搜尋，如"camera"。
 - 結果中顯示匹配的解決方案，可以進一步根據元件類別等過濾條件(如：適配的開發板，核心）精確篩選。
 - 查詢合適的解決方案，點選檢視解決方案詳情介紹

2. **定製解決方案元件包。**
 - 仔細閱讀解決方案的說明，以瞭解該解決方案的使用場景、特性、使用方法以及如何進行定製化，如下圖所示。
 - 點選「直接下載」，將解決方案下載到本地。
 - 點選「定製元件」，將對解決方案包含的元件進行定製。

3. **定製元件。**
- 下載的壓縮檔案並未包含原始碼的原始檔案，可以在IDE中匯入下載的壓縮包，解壓後執行hpm的安裝指令(hpm install），才會將所需要的元件全部下載下來。

- 下載的元件存在工程目錄下的ohos_bundles資料夾中。
1. 進入解決方案定製頁面，如下圖所示。
2. 透過關閉開關移除可選元件，或者透過“新增元件”增加新的元件。
3. 在右邊填寫您的專案基本資訊，包括名稱、版本、描述等資訊。
4. 點選“下載“，系統會根據您的選擇，生成相應的OpenHarmony程式碼結構檔案(如name.zip)，儲存至本地檔案。

# 獲取方式3：用包管理器命令列獲取
## 適用場景
- 使用者已透過元件式獲取的方式獲取原始碼，需要對原始碼中的某個或某幾個元件進行獨立升級。
- 使用者已經比較熟悉OpenHarmony系統的開發並且熟練掌握命令列工具的使用。

## 準備
  透過命令列獲取，需要先安裝Node.js和hpm命令列工具，安裝步驟如下：

1. 安裝Node.js。
 官網下載並在本地安裝Node.js.
推薦安裝 Node.js 12.x (包含 npm 6.14.4)或更高版本 (推薦 12.13.0+)。

2. 透過Node.js自帶的npm安裝hpm命令列工具。
開啟CMD，執行以下命令：

```bash
npm install -g @ohos/hpm-cli
```

3. 安裝完成後執行如下命令，顯示hpm版本，即安裝成功。

```bash
hpm -V 或 hpm --version
```

4. 如果升級hpm的版本，請執行如下命令：

```bash
npm update -g @ohos/hpm-cli
```

## 操作
  接下來將元件新增到開發專案中，假定要獲取的元件名為@ohos/demo，具體操作如下：
1. 進入開發目錄，執行如下命令，採用預設模板建立一個開發專案。

```bash
hpm init -t default
```

2. 執行如下命令，安裝元件@ohos/demo

```bash
hpm install @ohos/demo
```

3. 工具會自動從伺服器下載所有依賴的元件，下載成功則顯示Install successfully!

```bash
$ hpm install @ohos/demoRequesting: https://url.foo.bar/hpm/registry/api/bundles/@ohos/demodownloading @ohos/demoRequesting: https://lfcontentcenterdev....../bMAlLrYISLqdUTFFFCdgzA.tgzextract D:\demo\ohos_bundles\@ohos\demo\@ohos-demo-1.0.7.tgzInstall successfully!
```

# 獲取方式4：從程式碼倉庫獲取
## 適用場景
- 基於OpenHarmony的穩定分支建立自己的基線，分發下游客戶。
- 已經完成自身軟體與OpenHarmony的對接，需要進行OpenHarmony官方認證。
- 晶片/模組/app透過OpenHarmony官方認證後，貢獻程式碼到OpenHarmony生態。
- 修復OpenHarmony的問題。
- 學習OpenHarmony的原始碼。

## 準備
1. 註冊碼雲gitee賬號。
2. 註冊碼雲SSH公鑰，請參考碼雲幫助中心的公鑰管理：[https://gitee.com/help/articles/4181](https://gitee.com/help/articles/4181)
3. 安裝git客戶端並配置使用者資訊。

```bash
git config --global user.name "yourname"git config --global user.email "your-email-address"git config --global credential.helper store
```

4. 安裝碼雲repo工具，可以執行如下命令。

```bash
curl https://gitee.com/oschina/repo/raw/fork_flow/repo-py3 > /usr/local/bin/repochmod a+x /usr/local/bin/repopip install -i https://pypi.tuna.tsinghua.edu.cn/simple requests
```

## 操作
方式一（推薦）：透過repo下載

```bash
repo init -u https://gitee.com/openharmony/manifest.git -b master --no-repo-verifyrepo sync -c
```

方式二：透過git clone單個程式碼倉庫
  進入程式碼倉庫主頁：[https://gitee.com/openharmony](https://gitee.com/openharmony) ，選擇需要克隆的程式碼倉庫，執行命令，如：

```bash
git clone https://gitee.com/openharmony/manifest.git -b master
```

## 原始碼目錄簡介
  下表是OpenHarmony原始碼的目錄及簡單說明：

---
HarmonyOS官方開發者論壇：[https://developer.huawei.com/consumer/cn/forum/blockdisplay?fid=0101303901040230869](https://developer.huawei.com/consumer/cn/forum/blockdisplay?fid=0101303901040230869)

原文連結：[https://developer.huawei.com/consumer/cn/forum/topicview?tid=0202350736685590542&fid=0101303901040230869](https://developer.huawei.com/consumer/cn/forum/topicview?tid=0202350736685590542&fid=0101303901040230869)

原作者：kelly

HarmonyOS原始碼獲取大全

相關文章