云開發工程模板
DevEco Studio目前提供了兩種云開發工程模板:通用云開發模板和商城模板。您可根據工程向導輕松創建端云一體化開發工程,并自動生成對應的代碼和資源模板。在創建端云一體化開發工程前,請提前了解云開發工程模板的相關信息。
需要注意的是,在您體驗使用云開發模板創建的應用前,需前往AGC控制臺啟用手機號碼認證并使用手機號碼登錄應用。
新建HarmonyOS應用工程
前提條件
- 您已使用已實名認證的華為開發者帳號登錄DevEco Studio。
- 請確保您的華為開發者帳號余額充足,賬戶欠費將導致云存儲服務開通失敗。
選擇云開發模板
1.選擇以下任一種方式,打開工程創建向導界面。如果當前未打開任何工程,可以在DevEco Studio的歡迎頁點擊“Create Project”開始創建一個新工程。如果已經打開了工程,可以在菜單欄選擇“File > New > Create Project”來創建一個新工程。
2.在“Application”頁簽,選擇需要的云開發模板(下文以商城模板為例),然后點擊“Next”。
NOTE
使用商城模板,請先點擊“Template Market”進入模板市場進行下載,下載成功后即可在“Application”頁簽選擇到該模板。
配置工程信息
1.在工程配置界面,配置工程的基本信息。
2.點擊“Next”,開始關聯云開發資源。
關聯云開發資源
為工程關聯云開發所需的資源,即在DevEco Studio中選擇您的華為開發者帳號加入的開發者團隊,將該團隊在AGC的同包名應用關聯到當前工程。具體操作如下:
1.(可選)如您尚未登錄DevEco Studio,點擊“Sign in”,在彈出的帳號登錄頁面,使用已實名認證的華為開發者帳號完成登錄。
登錄成功后,界面將展示帳號昵稱。
2.點擊“Team”下拉框,選擇開發團隊。
NOTICE
團隊帳號持有者需為團隊完成實名認證。
3.關聯應用。
選中團隊后,系統根據工程包名在該團隊中自動查詢AGC上的同包名應用。
- 如查詢到應用,選中該應用,點擊“Finish”即可。
- 如查詢到的應用尚未關聯任何項目,則無法選中。請先將應用添加到您的項目下。
- 如果查詢到的應用所屬項目尚未啟用數據處理位置,請點擊界面提示內的“AppGallery Connect”設置數據處理位置。
NOTICE
由于云開發目前僅支持中國站點,請確保項目啟用的數據處理位置包含中國站點。
無論項目啟用的默認數據處理位置為哪個站點,后續開發的云服務資源都將部署在中國站點。
- 如在當前團隊中未查詢到同包名應用,請先確認填寫的包名是否有誤。
- 如包名有誤,點擊界面提示中的“go back”返回工程信息配置界面進行修改。
- 如包名無誤,則表明當前團隊尚未在AGC控制臺創建與當前工程包名相同的應用。您可點擊界面提示中的“AppGallery
Connect”,前往AGC控制臺創建同包名應用。
完成以上操作后,DevEco Studio即可獲取到同包名應用信息。選中應用后,點擊“Finish”。
4.如您所屬的團隊尚未簽署云開發相關協議,點擊協議鏈接仔細閱讀協議內容后,勾選同意協議,點擊“Finish”,進入主開發界面。
NOTE
只有帳號持有者和法務角色才有權限簽署協議。
5.在主開發界面,可查看剛剛新建的工程。關于工程的詳細目錄結構介紹,請參見端云一體化開發工程介紹。
新建元服務工程
前提條件
- 您已使用已實名認證的華為開發者帳號登錄DevEco Studio。
- 請確保您的華為開發者帳號余額充足,賬戶欠費將導致云存儲服務開通失敗。
選擇云開發模板
1.選擇以下任一種方式,打開工程創建向導界面。
- 如果當前未打開任何工程,可以在DevEco Studio的歡迎頁點擊“Create Project”開始創建一個新工程。
- 如果已經打開了工程,可以在菜單欄選擇“File > New > Create Project”來創建一個新工程。
2.點擊“Atomic Service”頁簽,選擇預置的通用云開發模板,然后點擊“Next”。
NOTE
元服務工程暫不支持選擇商城模板。
元服務調試、運行時,在設備桌面上沒有應用圖標,請使用DevEco Studio的調試和運行功能,來啟動元服務。
元服務是免安裝的,Stage模型中在module.json5文件自動添加“installationFree”字段,取值為“true”;在app.json5文件自動添加“bundleType”字段,取值為 “atomicService”。
編譯構建APP時,每個HAP大小不能超過10MB。
配置工程信息
1.在工程配置界面,配置工程的基本信息。
2.點擊“Next”,開始關聯云開發資源。
關聯云開發資源
為工程關聯云開發所需的資源,即在DevEco Studio中選擇您的華為開發者帳號加入的開發者團隊,將該團隊在AGC的同包名應用關聯到當前工程。具體操作如下:
1.(可選)如您尚未登錄DevEco Studio,點擊“Sign in”,在彈出的帳號登錄頁面,使用已實名認證的華為開發者帳號完成登錄。
登錄成功后,界面將展示帳號昵稱。
2.點擊“Team”下拉框,選擇開發團隊。
NOTICE
團隊帳號持有者需為團隊完成實名認證。
3.關聯應用。
選中團隊后,系統根據工程包名在該團隊中自動查詢AGC上的同包名應用。
- 如查詢到應用,選中該應用,點擊“Finish”即可。
- 如查詢到的應用尚未關聯任何項目,則無法選中。請先將應用添加到您的項目下。
- 如果查詢到的應用所屬項目尚未啟用數據處理位置,請點擊界面提示內的“AppGallery Connect”設置數據處理位置。
NOTICE
由于云開發目前僅支持中國站點,請確保項目啟用的數據處理位置包含中國站點。
無論項目啟用的默認數據處理位置為哪個站點,后續開發的云服務資源都將部署在中國站點。
- 如在當前團隊中未查詢到同包名應用,請先確認填寫的包名是否有誤。
- 如包名有誤,點擊界面提示中的“go back”返回工程信息配置界面進行修改。
- 如包名無誤,則表明當前團隊尚未在AGC控制臺創建與當前工程包名相同的應用。您可點擊界面提示中的“AppGallery
Connect”,前往AGC控制臺創建同包名應用。
完成以上操作后,DevEco Studio即可獲取到同包名應用信息。選中應用后,點擊“Finish”。
4.如您所屬的團隊尚未簽署云開發相關協議,點擊協議鏈接仔細閱讀協議內容后,勾選同意協議,點擊“Finish”,進入主開發界面。
NOTE
只有帳號持有者和法務角色才有權限簽署協議。
5.在主開發界面,可查看剛剛新建的工程。關于工程的詳細目錄結構介紹,請參見端云一體化開發工程介紹。
工程初始化配置
當您成功創建工程并關聯云開發資源后,DevEco Studio會為您的工程自動執行一些初始化配置。
自動開通云開發相關服務
DevEco Studio為工程關聯的項目自動開通云開發相關服務:認證服務、云函數、云數據庫、云托管、API網關、云存儲。您可在“Notifications”窗口查看服務開通狀態。
NOTE
如服務開通失敗,您可隨界面引導前往AGC控制臺進行手動開通。
如云存儲服務自動開通與手動開通均失敗,可能是賬戶欠費導致。請您,后再前往AGC控制臺進行手動開通。
端側工程自動集成AGC SDK
DevEco Studio為端側工程自動集成AGC相關云服務最新版本SDK。
- “entry/src/main/resources/rawfile/agconnect-services.json”:AGC
SDK配置文件,內含client_secret和api_key,請妥善保管。
-
“entry/oh-package.json5”:自動引入了AGC相關云服務(認證服務、云函數、云存儲)最新版本SDK,同時會自動集成端云一體化登錄組件的最新SDK。
工程同步成功后可以看到當前從ohpm倉獲取的最新版本。
云側工程自動集成云數據庫SDK
DevEco Studio為云側工程自動集成云數據庫最新版本Node.js Server SDK。
“cloudfunctions/函數目錄名 (如下圖idgenerator)/package.json”:自動引入云數據庫最新版本的Node.js Server SDK。
端云一體化開發工程介紹
端云一體化開發工程目錄分為三個子工程:端開發工程(Application)、云開發工程(CloudProgram)、端側公共庫(External Libraries)。
端開發工程(Application)
端開發工程主要用于開發應用端側的業務代碼,端開發工程目錄結構請參見工程介紹。
NOTICE
使用DevEco Studio 3.1 Beta1創建的工程采用的是npm包管理,而使用DevEco Studio 3.1 Release新建工程將使用ohpm作為默認包管理器。因此,在您升級到DevEco Studio 3.1 Release版本后,打開歷史工程可能會出現兼容性問題,您需參考OHPM包管理器進行工程遷移。
云開發工程(CloudProgram)
在云開發工程中,您可為您的應用開發云函數和云數據庫服務資源。云開發工程目錄結構如下圖所示:
- clouddb:云數據庫工程目錄。
- dataentry:用于存放數據條目文件。
NOTE
使用通用云開發模板創建的工程會默認生成post_data數據條目文件,使用商城模板創建的云開發工程則會默認生成sku(商品基本屬性)、spu(商品擴展屬性)以及spu_attr(商品規格屬性)數據條目文件。您可按需修改。
- objecttype:用于存放對象類型文件。
NOTE
使用通用云開發模板創建的工程會默認生成post對象類型文件,使用商城模板創建的云開發工程會默認生成order(訂單)、shopcart(購物車)等多個對象類型文件。您可按需修改。
- db-config.json:模塊配置文件,主要包含云數據庫工程的配置信息,如默認存儲區名稱、默認數據處理位置。
- cloudfunctions:云函數工程目錄。
NOTE
使用通用云開發模板創建的工程默認自動創建一個示例函數“idgenerator”,使用商城模板創建的云開發工程會默認生成mall-address(地址)、mall-commodity(商品)等多個函數。您可按需修改。
- node_modules:包含了所有第三方依賴。
- cloud-config.json:云開發工程配置文件,包含應用名稱與ID、項目名稱與ID、啟用的數據處理位置、支持的設備類型等。
- package.json:定義了TypeScript公共依賴。
- package-lock.json:記錄當前狀態下實際安裝的各個npm package的具體來源和版本號。
端側公共庫(External Libraries)
端側公共庫中包含了JDK的擴展類庫。
那么要想成為一名鴻蒙高級開發,以上知識點是必須要掌握的,除此之外,還需要掌握一些鴻蒙應用開發相關的一些技術,需要我們共同去探索。
為了能夠讓大家跟上互聯網時代的技術迭代,在這里我特邀了幾位行業大佬整理出一份最新版的鴻蒙學習提升資料,有需要的小伙伴自行領取,限時開源,先到先得~~~~
領取以下高清學習路線原圖請點擊→《鴻蒙基礎入門學習指南》純血鴻蒙HarmonyOS基礎技能學習路線圖
領取以上完整高清學習路線圖,請點擊→《鴻蒙全套學習指南》小編自己整理的部分學習資料(包含有高清視頻、開發文檔、電子書籍等)
以上分享的學習路線都適合哪些人跟著學習?
-應屆生/計算機專業通過學習鴻蒙新興技術,入行互聯網,未來高起點就業。
-0基礎轉行提前布局新方向,抓住風口,自我提升,獲得更多就業機會。
-技術提升/進階跳槽發展瓶頸期,提升職場競爭力,快速掌握鴻蒙技術,享受藍海紅利。
最后
鴻蒙開發學習是一個系統化的過程,從基礎知識的學習到實戰技能的錘煉,再到對前沿技術的探索,每一環節都至關重要。希望這份教程資料能幫助您快速入門并在鴻蒙開發之路上步步攀升,成就一番事業。讓我們一起乘風破浪,擁抱鴻蒙生態的廣闊未來!
如果你覺得這篇內容對你有幫助,我想麻煩大家動動小手給我:點贊,轉發,有你們的 『點贊和評論』,才是我創造的動力。
關注我,同時可以期待后續文章ing,不定期分享原創知識。
想要獲取更多完整鴻蒙最新VIP學習資料,請點擊→《鴻蒙 (Harmony OS)開發學習手冊》