還在為找不到想看的文檔內(nèi)容發(fā)愁？一文帶你熟知應(yīng)用開發(fā)文檔

作者：HarmonyOS技術(shù)社區(qū) 2021-07-19 10:10:25

HarmonyOS作為新一代的智能終端操作系統(tǒng)，為不同設(shè)備的智能化、互聯(lián)與協(xié)同提供了統(tǒng)一的語言。帶來簡潔，流暢，連續(xù)，安全可靠的全場景交互體驗。

https://harmonyos.51cto.com

HarmonyOS作為新一代的智能終端操作系統(tǒng)，為不同設(shè)備的智能化、互聯(lián)與協(xié)同提供了統(tǒng)一的語言。帶來簡潔，流暢，連續(xù)，安全可靠的全場景交互體驗。隨著HarmonyOS SDK 2.1 Release發(fā)布，HarmonyOS應(yīng)用開發(fā)文檔也上新各種技術(shù)內(nèi)容。

版本定義及更新說明

版本類型定義及版本更新一向是開發(fā)者們最關(guān)注的內(nèi)容之一，我們也歸檔了歷次版本更新內(nèi)容，開發(fā)者們可在“文檔”區(qū)的“版本說明”目錄下找到版本配套信息、版本更新內(nèi)容及對應(yīng)的開發(fā)者文檔(如圖1所示)。

還在為找不到想看的文檔內(nèi)容發(fā)愁？一文帶你熟知應(yīng)用開發(fā)文檔-鴻蒙HarmonyOS技術(shù)社區(qū)

圖1 版本說明圖

● 版本說明

https://developer.harmonyos.com/cn/docs/documentation/doc-releases/harmonyos_release_2_20210625-0000001123724872

示例代碼專區(qū)

示例代碼是廣大開發(fā)者最需要的學(xué)習(xí)資源，也是開發(fā)者千呼萬喚的干貨內(nèi)容。當(dāng)前文檔上架了示例代碼展示區(qū)(如圖2所示)，**方便開發(fā)者一站式獲取所有示例代碼內(nèi)容，**了解如何實現(xiàn)特定功能，并支持從Gitee社區(qū)獲取源碼學(xué)習(xí)和參考。

圖2 示例代碼展示區(qū)

示例代碼

https://developer.harmonyos.com/cn/documentation/Samples/

同時，我們還在指南專題對應(yīng)內(nèi)容中，增加了相關(guān)實例的快速鏈接，方便開發(fā)者在學(xué)習(xí)相關(guān)主題內(nèi)容后可快速獲取實例代碼，上手實踐(如圖3所示)。

圖3 相關(guān)示例展示圖

開發(fā)者教程

開發(fā)者教程通過生動有趣的場景案例、簡單易上手的代碼，Step by Step指導(dǎo)開發(fā)者針對重點功能或場景進行開發(fā)。大家可在“開發(fā)”專區(qū)的“Codelabs”目錄下獲取到當(dāng)前所有的開發(fā)者教程資源。

Codelabs鏈接

https://developer.harmonyos.com/cn/develop/codelabs/

特色主題文檔

1.了解原子化服務(wù)

在萬物互聯(lián)時代，人均持有設(shè)備量不斷攀升，設(shè)備和場景的多樣性，使應(yīng)用開發(fā)變得更加復(fù)雜、應(yīng)用入口更加豐富。在此背景下，應(yīng)用提供方和用戶迫切需要一種新的服務(wù)提供方式，使應(yīng)用開發(fā)更簡單、服務(wù)(如聽音樂、打車等)的獲取和使用更便捷。為此，HarmonyOS除支持傳統(tǒng)方式的需要安裝的應(yīng)用外，還支持提供特定功能的免安裝的應(yīng)用(即原子化服務(wù))。

原子化服務(wù)是HarmonyOS提供的一種面向未來的服務(wù)提供方式，是有獨立入口的(用戶可通過點擊方式直接觸發(fā)，如圖4所示)、免安裝的(無需顯式安裝，由系統(tǒng)程序框架后臺安裝后即可使用)、可為用戶提供一個或多個便捷服務(wù)的用戶應(yīng)用程序形態(tài)。例如：某傳統(tǒng)方式的需要安裝的購物應(yīng)用A，在按照原子化服務(wù)理念調(diào)整設(shè)計后，成為由“商品瀏覽”、“購物車”、“支付”等多個便捷服務(wù)組成的、可以免安裝的購物原子化服務(wù)A*。

還在為找不到想看的文檔內(nèi)容發(fā)愁？一文帶你熟知應(yīng)用開發(fā)文檔-鴻蒙HarmonyOS技術(shù)社區(qū)

圖4 服務(wù)中心示意圖

更多關(guān)于原子化服務(wù)的具體詳情，可參見官網(wǎng)【原子化服務(wù)】資料。

【原子化服務(wù)】

https://developer.harmonyos.com/cn/docs/documentation/doc-guides/atomic-service-definition-0000001090840664

2.服務(wù)卡片開發(fā)指南

服務(wù)卡片(以下簡稱“卡片”)是FA的一種界面展示形式，將FA的重要信息或操作前置到卡片，以達到服務(wù)直達，減少體驗層級目的。

卡片常用于嵌入到其他應(yīng)用(當(dāng)前只支持系統(tǒng)應(yīng)用)中作為其界面的一部分顯示，并支持拉起頁面，發(fā)送消息等基礎(chǔ)的交互功能。卡片使用方負責(zé)顯示卡片。

卡片使用方是顯示卡片內(nèi)容的宿主應(yīng)用，控制卡片在宿主中展示的位置。卡片管理服務(wù)是用于管理系統(tǒng)中所添加卡片的常駐代理服務(wù)，包括卡片對象的管理與使用，以及卡片周期性刷新等。

卡片提供方提供卡片顯示內(nèi)容的HarmonyOS應(yīng)用或原子化服務(wù)，控制卡片的顯示內(nèi)容、控件布局以及控件點擊事件。

圖5 服務(wù)卡片展示圖

更多關(guān)于服務(wù)卡片開發(fā)的具體詳情，可參見官網(wǎng)【服務(wù)卡片】資料。

【服務(wù)卡片】

https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ability-service-widget-overview-0000001062607955

3.流轉(zhuǎn)開發(fā)指南

流轉(zhuǎn)在HarmonyOS中泛指多設(shè)備分布式操作(如圖6所示)。流轉(zhuǎn)能力打破設(shè)備界限，多設(shè)備聯(lián)動，使用戶應(yīng)用程序可分可合、可流轉(zhuǎn)，實現(xiàn)如郵件跨設(shè)備編輯、多設(shè)備協(xié)同健身、多屏游戲等分布式業(yè)務(wù)。流轉(zhuǎn)為開發(fā)者提供更廣的使用場景和更新的產(chǎn)品視角，強化產(chǎn)品優(yōu)勢，實現(xiàn)體驗升級。流轉(zhuǎn)按照體驗可分為跨端遷移和多端協(xié)同。

跨端遷移是一種實現(xiàn)用戶應(yīng)用程序流轉(zhuǎn)的技術(shù)方案，當(dāng)前僅傳統(tǒng)方式的需要安裝的應(yīng)用支持，原子化服務(wù)暫不支持。指在A端運行的FA遷移到B端上，完成遷移后， B端FA繼續(xù)任務(wù)，而A端應(yīng)用退出。在用戶使用設(shè)備的過程中，當(dāng)使用情境發(fā)生變化時(例如：從室內(nèi)走到戶外或者周圍有更合適的設(shè)備等)，之前使用的設(shè)備可能已經(jīng)不適合繼續(xù)當(dāng)前的任務(wù)，此時，用戶可以選擇新的設(shè)備來繼續(xù)當(dāng)前的任務(wù)。

圖6 流轉(zhuǎn)示意圖

更多關(guān)于流轉(zhuǎn)開發(fā)的具體詳情，可參見官網(wǎng)【流轉(zhuǎn)】資料。

【流轉(zhuǎn)】

https://developer.harmonyos.com/cn/docs/documentation/doc-guides/hop-overview-0000001092995092

4.Java UI

Java UI框架已為大家提供了20多種常用定義組件和布局、自定義組件和布局的開發(fā)指導(dǎo)(如圖7所示)，Java與XML方式隨需使用，更多關(guān)于Java UI開發(fā)詳情，可參見官網(wǎng)【Java UI】。

圖7 Java UI框架資料展示圖

【Java UI】

https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ui-java-component-webview-0000001092715158

真機調(diào)試指導(dǎo)

HarmonyOS應(yīng)用調(diào)試支持使用真機設(shè)備調(diào)試，開發(fā)者使用真機設(shè)備進行調(diào)試前，需要先對HAP進行簽名后再進行調(diào)試(如圖8所示)。在DevEco Studio 2.1 Release版本中，我們提供了自動簽名的功能，開發(fā)者無需再手動去制作證書請求文件、申請調(diào)測證書等復(fù)雜操作。此外，DevEco Studio支持Java、JS、C/C單語言調(diào)試和JS+Java、Java+C/C跨語言調(diào)試能力，同時還支持分布式應(yīng)用的跨設(shè)備調(diào)試，提升了應(yīng)用調(diào)測的效率。

圖8 真機設(shè)備調(diào)試流程圖

更多關(guān)于使用真機設(shè)備調(diào)試的詳情，可參見官網(wǎng)【使用真機設(shè)備調(diào)試】。

【使用真機設(shè)備調(diào)試】

https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ide_debug_device-0000001053822404

常見問題

大家在開發(fā)、調(diào)試總會遇到一些阻礙，建議大家先查找文檔，尤其是相關(guān)主題的開發(fā)指南、API參考，鼓勵大家查閱《常見問題》中的相關(guān)問題(如圖9所示)。這些常見問題主要來自開發(fā)者在論壇、社區(qū)等渠道的高頻求助問題，文檔團隊例行收集高頻問題，不斷豐富常見問題內(nèi)容。