隨著HarmonyOS發布，服務卡片這一功能也走進了人們的視線。它以其直觀可視的展現形式，流暢的運行速度，刷新了人們對以往APP的認識。

正值黨的百年華誕，我們在學習黨史的時候，利用服務卡片功能，開發出可以快速學習黨史的這款卡片，并取名為“薪火”。

一

創建“薪火”app工程1安裝和配置DevEco Studio 2.1 Release

安裝的鏈接：https://developer.harmonyos.com/cn/develop/deveco-studioIDE的使用指南，很詳細：https://developer.harmonyos.com/cn/docs/documentation/doc-guides/tools_overview-0000001053582387我的本案例使用的最新的 2.1.0.501版本，SDK：API Version 5

2創建一個Empty Java Phone應用

點擊Next

點擊Finish完成創建薪火app工程

3薪火app頁面布局

首先完成薪火app頁面的布局，代碼如下：

二

薪火app卡片實現

第一步：卡片生成

鼠標放在項目的包路徑上，然后右擊，點擊“Service Widget”，然后就可以創建服務卡片

選擇“Basic”高級模式，然后再Template中選擇 “Grid Pattern”模板，然后點擊Next

然后給服務卡片起名字，這里要就寫個“FireWoodCard”，選擇生成卡片的樣式，分別為2X2、2X4、4X4規格，然后點擊“Finish”完成創建。

然后會生成相關的模板代碼，如下是代碼的框架：

然后對FireWoodCardAbility.java 和form_grid_pattern_firewoodcard_*.xml布局文件修改，并新增準備好的資源文件。

第二步：卡片布局的修改

我們制作了一個規格分別為2X2、2X4和4X4三種類型的服務卡片

第三步：卡片信息創建、更新、刪除

對卡片進行操作時，需要將創建的卡片信息持久化，以便在下次獲取/更新該卡片實例時進行使用。我們采用對象關系型數據庫來存儲卡片信息，主要是在卡片創建的回調函數onCreateForm和卡片銷毀的回調函數onDeleteForm中存儲和刪除卡片信息。卡片需要存儲的信息包括：卡片ID、卡片名稱、卡片大小（2X2還是4X4等），代碼如下所示。

1、存儲卡片信息：

2、更新卡片信息：

3、刪除卡片信息：

卡片創建完成。

第四步：卡片在桌面的創建方式

在手機桌面上卡片的創建方式分為：設為上滑卡片或添加到桌面。

注：手動在桌面上上滑時，卡片會自動撤銷。

注：手動長按卡片可以進行移除卡片和添加其他規格的卡片。

第五步：卡片的點擊跳轉

卡片默認跳轉到薪火app主頁，可以查看到當前app上的熱搜新聞，點擊新聞會自動跳轉到對應新聞的詳細內容頁面。

卡片頁面跳轉到APP新聞頁面功能的重點代碼如下：

新聞列表頁面跳轉到新聞詳情頁面功能的重點代碼如下：

通過案例充分說明了卡片的獨特優點：能夠將FA的重要信息或操作前置到卡片，以達到服務直達，減少體驗層級目的。

總結和回顧

本文通過薪火+薪火服務卡片，手把手的教會大家如何實現一個HarmonyOS Java卡片，你將學會以下知識點：1）如何使用模板創建卡片2）卡片的布局3）卡片信息創建、更新和刪除過程4）卡片的點擊跳轉事件

除此以外，你還會學到：

1）如何使用webview控件進行網絡請求獲取數據

2）如何使用ListContainer做一個列表

參考HarmonyOS開發者技術文檔：

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

3）如何使用偏好型數據庫，緩存卡片信息

創建服務卡片：

更新服務卡片：

刪除服務卡片：

責任編輯：haq