一、導入 Sample 工程

① Sample 說明

• DevEco Studio 支持 HarmonyOS Sample 工程的導入功能，通過對接 Gitee 開源社區中的 Sample 資源，可一鍵導入 Sample 工程到 DevEco Studio 中。
• 目前，HarmonyOS 和 OpenHarmony 的 Sample 均在同一個 Gitee 倉中，但 OpenHarmony 的 Sample 示例并不適用于 HarmonyOS SDK。在導入時，請不要導入在 Sample 簡介中存在 “This sample is intended for novices at developing OpenHarmony applications.” 說明的 Sample，例如：

② Sample 導入方法

• 在 DevEco Studio 的歡迎頁，進入 Configure > Settings > Version Control > Git 界面，點擊 Test 按鈕檢測是否安裝 Git 工具：
• • 已安裝，請根據下一步開始導入 Sample；

• • 未安裝，請點擊 Download and Install，DevEco Studio 會自動下載并安裝。安裝完成后，請根據第二步開始導入Sample；

• 在 DevEco Studio 的歡迎頁，點擊 Import HarmonyOS Sample 按鈕，導入 Sample 工程（在打開工程的情況下，可以點擊 File > New > Import HarmonyOS Sample 來進行導入）：

• 選擇需要導入的 Sample 工程，然后點擊 Next：

• 設置 App Name 和 Project Location，然后點擊 Finish，等待 Sample 工程導入完成：

• 導入 Sample 后，等待工程同步完成即可。

③ 導入 Sample 時，提示連接 Gitee 超時

• 導入 Sample 時，導入失敗，提示“Failed to connect to gitee.com port 443: Time out”連接超時。
• 該問題一般是由于網絡受限導致，請檢查網絡連接狀態。如果網絡受限，需要通過代理服務器訪問網絡，請執行以下操作，配置 git 代理信息。
• • 進入 Git 安裝目錄（默認為C:\Program Files\Git），雙擊運行“git-cmd.exe”文件。
• • 在打開的命令行窗口中，執行以下命令配置代理服務器信息（將 proxyUsername、ProxyPassword、proxyserver 和 port 按照實際代理服務器進行修改）。

git config --global http.proxy http://proxyUsername:proxyPassword@proxy.server.com:portgit config --global http.https://gitee.com.proxy http://proxyUsername:proxyPassword@proxy.server.com:port

• • 執行完成后，請重新嘗試導入Sample。

④ 導入 Sample 時，提示 SSL 證書校驗錯誤

• 導入 Sample 時，導入失敗，提示“SSL certificate problem: unable to get local issuer certificate”證書校驗錯誤。
• 出現這個錯誤可能是網絡遭受了攻擊，或者你的網絡提供方網絡策略組織了相關操作，如果你確認所處的網絡環境安全，可以臨時關閉證書校驗以獲取 Sample：
• • 進入 Git 安裝目錄（默認為C:\Program Files\Git），雙擊運行“git-cmd.exe”文件。
• • 在打開的命令行窗口中，執行如下命令關閉 SSL 證書校驗功能。

git config --global http.https://gitee.com.sslVerify false

• • 執行完成后，請重新嘗試導入 Sample。

二、添加 Module

① Module 單元

• Module 是 HarmonyOS 應用的基本功能單元，包含了源代碼、資源文件、第三方庫及應用清單文件，每一個 Module 都可以獨立進行編譯和運行。
• 一個 HarmonyOS 應用通常會包含一個或多個 Module，因此，可以在工程中，創建多個 Module，每個 Module 分為 Ability 和 Library（其中 Library 包括 HarmonyOS Library 和 Java Library）兩種類型。
• 在一個 APP 中，對于同一類型設備有且只有一個 Entry Module，其余 Module 的類型均為 Feature。
• 因此，在創建一個類型為 Ability 的 Module 時，遵循如下原則：
• • 若新增 Module 的設備類型為已有設備時，則 Module 的類型將自動設置為“Feature”；
• • 若新增Module的設備類型為當前還沒有創建 Module，則 Module 的類型將自動設置為“Entry”。

② 新增 Module

• 通過如下兩種方法，在工程中添加新的 Module：
• • 方法一：鼠標移到工程目錄頂部，點擊鼠標右鍵，選擇 New>Module，開始創建新的 Module；
• • 方法二：在菜單欄選擇 File > New > Module，開始創建新的 Module。
• 在 New Project Module 界面中，選擇需要創建的模板：

• 點擊 Next，在 Module 配置頁面，設置新增 Module 的基本信息（Module 類型為 Ability 或者 HarmonyOS Library 時，請根據如下內容進行設置，然后點擊 Next）：
• • Application/Library name：新增 Module 所屬的類名稱。
• • Module Name：新增模塊的名稱。
• • Module Type：僅再 Ability 模板存在，工具自動根據設備類型下的模塊進行設置，設置規則請參考 Ability 的 Module 類型設置原則。
• • Package Name：軟件包名稱，可以點擊 Edit 修改默認包名稱，需全局唯一。
• • Compatible API Version：兼容的 SDK 最低版本。
• • Device Type：選擇模塊的設備類型，如果新建模塊的 Module Type 為 Feature，則只能選擇該工程原有的設備類型；如果 Module Type 為 Entry，可以選擇該 Module 支持的其他設備類型。
• • Show in Service Center：是否在服務中心露出，僅在 Ability 模板存在。如果工程類型為 HarmonyOS Service，則會同步創建一個2*2的服務卡片模板，同時還會創建入口卡片；如果工程類型為HarmonyOS Application，則只會創建一個2 * 2的服務卡片模板。

• Module 類型為 Java Library 時，請根據如下內容進行設置，然后點擊 Finish 完成創建：
• • Library name：Java Library 類名稱。
• • Java package name：軟件包名稱，可以點擊 Edit 修改默認包名稱，需全局唯一。
• • Java class name：class 文件名稱。
• • Create.gitignore file：是否自動創建 .gitignore文件，勾選表示創建。

• 設置新增 Ability 的 Page Name 和 Layout Name，若該 Module 的模板類型為 Ability，還需要設置 Visible 參數，表示該 Ability 是否可以被其它應用所調用：
• • 勾選（true）：可以被其它應用調用；
• • 不勾選（false）：不能被其它應用調用。
• 點擊 Finish，等待創建完成后，可以在工程目錄中查看和編輯新增的 Module。

③ 刪除 Module

• 為防止開發者在刪除 Module 的過程中，誤將其它的模塊刪除，DevEco Studio 提供統一的模塊管理功能，需要先在模塊管理中，移除對應的模塊后，才允許刪除。
• 在菜單欄中選擇 File > Project Structure > Modules，選擇需要刪除的 Module，點擊“-”按鈕，并在彈出的對話框中點擊 Yes。

• 在工程目錄中選中該模塊，點擊鼠標右鍵，選中 Delete，并在彈出的對話框中點擊 Delete。

總結

以上是生活随笔為你收集整理的HarmonyOS之在工程中导入Sample工程和添加Module的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。