還在為找不到想看的文檔內容發愁？一文帶你熟知應用開發文檔
HarmonyOS作為新一代的智能終端操作系統，為不同設備的智能化、互聯與協同提供了統一的語言。帶來簡潔，流暢，連續，安全可靠的全場景交互體驗。隨著HarmonyOS SDK 2.1 Release發布，HarmonyOS應用開發文檔也上新各種技術內容。
版本定義及更新說明
版本類型定義及版本更新一向是開發者們最關注的內容之一，我們也歸檔了歷次版本更新內容，開發者們可在“文檔”區的“版本說明”目錄下找到版本配套信息、版本更新內容及對應的開發者文檔(如圖1所示)。
圖1 版本說明圖
● 版本說明
示例代碼專區
示例代碼是廣大開發者最需要的學習資源，也是開發者千呼萬喚的干貨內容。當前文檔上架了示例代碼展示區(如圖2所示)，**方便開發者一站式獲取所有示例代碼內容，**了解如何實現特定功能，并支持從Gitee社區獲取源碼學習和參考。
圖2 示例代碼展示區
- 示例代碼
https://developer.harmonyos.com/cn/documentation/Samples/
同時，我們還在指南專題對應內容中，增加了相關實例的快速鏈接，方便開發者在學習相關主題內容后可快速獲取實例代碼，上手實踐(如圖3所示)。
圖3 相關示例展示圖
開發者教程
開發者教程通過生動有趣的場景案例、簡單易上手的代碼，Step by Step指導開發者針對重點功能或場景進行開發。大家可在“開發”專區的“Codelabs”目錄下獲取到當前所有的開發者教程資源。
- Codelabs鏈接
https://developer.harmonyos.com/cn/develop/codelabs/
特色主題文檔
1.了解原子化服務
在萬物互聯時代，人均持有設備量不斷攀升，設備和場景的多樣性，使應用開發變得更加復雜、應用入口更加豐富。在此背景下，應用提供方和用戶迫切需要一種新的服務提供方式，使應用開發更簡單、服務(如聽音樂、打車等)的獲取和使用更便捷。為此，HarmonyOS除支持傳統方式的需要安裝的應用外，還支持提供特定功能的免安裝的應用(即原子化服務)。
原子化服務是HarmonyOS提供的一種面向未來的服務提供方式，是有獨立入口的(用戶可通過點擊方式直接觸發，如圖4所示)、免安裝的(無需顯式安裝，由系統程序框架后臺安裝后即可使用)、可為用戶提供一個或多個便捷服務的用戶應用程序形態。例如：某傳統方式的需要安裝的購物應用A，在按照原子化服務理念調整設計后，成為由“商品瀏覽”、“購物車”、“支付”等多個便捷服務組成的、可以免安裝的購物原子化服務A*。
圖4 服務中心示意圖
更多關于原子化服務的具體詳情，可參見官網【原子化服務】資料。
- 【原子化服務】
2.服務卡片開發指南
服務卡片(以下簡稱“卡片”)是FA的一種界面展示形式，將FA的重要信息或操作前置到卡片，以達到服務直達，減少體驗層級目的。
卡片常用于嵌入到其他應用(當前只支持系統應用)中作為其界面的一部分顯示，并支持拉起頁面，發送消息等基礎的交互功能。卡片使用方負責顯示卡片。
卡片使用方是顯示卡片內容的宿主應用，控制卡片在宿主中展示的位置。卡片管理服務是用于管理系統中所添加卡片的常駐代理服務，包括卡片對象的管理與使用，以及卡片周期性刷新等。
卡片提供方提供卡片顯示內容的HarmonyOS應用或原子化服務，控制卡片的顯示內容、控件布局以及控件點擊事件。
圖5 服務卡片展示圖
更多關于服務卡片開發的具體詳情，可參見官網【服務卡片】資料。
- 【服務卡片】
3.流轉開發指南
流轉在HarmonyOS中泛指多設備分布式操作(如圖6所示)。流轉能力打破設備界限，多設備聯動，使用戶應用程序可分可合、可流轉，實現如郵件跨設備編輯、多設備協同健身、多屏游戲等分布式業務。流轉為開發者提供更廣的使用場景和更新的產品視角，強化產品優勢，實現體驗升級。流轉按照體驗可分為跨端遷移和多端協同。
跨端遷移是一種實現用戶應用程序流轉的技術方案，當前僅傳統方式的需要安裝的應用支持，原子化服務暫不支持。指在A端運行的FA遷移到B端上，完成遷移后， B端FA繼續任務，而A端應用退出。在用戶使用設備的過程中，當使用情境發生變化時(例如：從室內走到戶外或者周圍有更合適的設備等)，之前使用的設備可能已經不適合繼續當前的任務，此時，用戶可以選擇新的設備來繼續當前的任務。
圖6 流轉示意圖
更多關于流轉開發的具體詳情，可參見官網【流轉】資料。
- 【流轉】
https://developer.harmonyos.com/cn/docs/documentation/doc-guides/hop-overview-0000001092995092
4.Java UI
Java UI框架已為大家提供了20多種常用定義組件和布局、自定義組件和布局的開發指導(如圖7所示)，Java與XML方式隨需使用，更多關于Java UI開發詳情，可參見官網【Java UI】。
圖7 Java UI框架資料展示圖
- 【Java UI】
真機調試指導
HarmonyOS應用調試支持使用真機設備調試，開發者使用真機設備進行調試前，需要先對HAP進行簽名后再進行調試(如圖8所示)。在DevEco Studio 2.1 Release版本中，我們提供了自動簽名的功能，開發者無需再手動去制作證書請求文件、申請調測證書等復雜操作。此外，DevEco Studio支持Java、JS、C/C單語言調試和JS+Java、Java+C/C跨語言調試能力，同時還支持分布式應用的跨設備調試，提升了應用調測的效率。
圖8 真機設備調試流程圖
更多關于使用真機設備調試的詳情，可參見官網【使用真機設備調試】。
- 【使用真機設備調試】
https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ide_debug_device-0000001053822404
常見問題
大家在開發、調試總會遇到一些阻礙，建議大家先查找文檔，尤其是相關主題的開發指南、API參考，鼓勵大家查閱《常見問題》中的相關問題(如圖9所示)。這些常見問題主要來自開發者在論壇、社區等渠道的高頻求助問題，文檔團隊例行收集高頻問題，不斷豐富常見問題內容。
- 《常見問題》-Java開發
圖9 常見問題展示圖
如果你在查閱文檔后仍有不能解決的問題，也歡迎通過以下方式高效解決：
https://developer.harmonyos.com/cn/support
開發者聲音回音壁
我們不斷收到廣大開發者的文檔需求和建議，每天都會投入一定的時間來分析大家的反饋。雖然我們無法直接回答大家的每一條的意見，但大家的需求和建議每天都會影響HarmonyOS開發者文檔的體驗提升。
我們希望本期的文檔上新內容，能夠給各位開發者的工作帶來一定幫助。同時，我們十分重視開發者的意見，歡迎各位開發者的積極反饋，正是因為你們的建議，讓我們堅持持續提升文檔體驗，感謝各位的支持及信賴，讓我們一起攜手，創造無限可能。
了解了這么多，何不從工具下載開始上手體驗呢?
HUAWEI DevEco Studio下載鏈接
https://developer.harmonyos.com/cn/develop/deveco-studio
