55.HarmonyOS NEXT 登錄模塊開發教程（九）：部署與發布

溫馨提示：本篇博客的詳細代碼已發布到 git : https://gitcode.com/nutpi/HarmonyosNext 可以下載運行哦！

HarmonyOS NEXT 登錄模塊開發教程（九）：部署與發布

效果預覽

1. 引言

在前八篇教程中，我們介紹了HarmonyOS NEXT登錄模塊的整體架構、模態窗口的實現原理、一鍵登錄頁面的實現、短信驗證碼登錄的實現、狀態管理和數據綁定機制、安全性考慮、UI設計和用戶體驗優化、性能優化和最佳實踐以及測試與調試技巧。本篇教程將深入講解登錄模塊的部署和發布流程，幫助開發者將登錄功能順利部署到實際環境中。

部署和發布是應用開發的最后一環，也是將開發成果轉化為用戶價值的關鍵步驟。在HarmonyOS NEXT中，應用的部署和發布有其特定的流程和要求，本教程將詳細介紹這些內容，確保登錄模塊能夠順利地集成到應用中并發布到應用市場。

2. 應用打包與簽名

2.1 應用打包概述

HarmonyOS NEXT應用的打包過程主要包括以下步驟：

編譯代碼：將ArkTS代碼編譯為可執行文件
打包資源：將圖片、字符串等資源文件打包
生成HAP包：生成Harmony Ability Package（HAP）文件
簽名驗證：對HAP包進行簽名，確保其完整性和來源可信

2.2 使用DevEco Studio打包應用

DevEco Studio提供了圖形化界面，簡化了應用打包過程：

在DevEco Studio中，選擇菜單欄的Build > Build Hap(s)/APP(s) > Build APP(s)
在彈出的對話框中，選擇要構建的模塊和配置
點擊OK按鈕，開始構建過程
構建完成后，HAP包將生成在項目的build/outputs/app/debug或build/outputs/app/release目錄下

2.3 應用簽名

應用簽名是確保應用完整性和來源可信的重要機制。HarmonyOS NEXT要求所有應用必須經過簽名才能安裝和運行。

2.3.1 創建簽名證書

# 使用keytool創建簽名證書
keytool -genkeypair -alias key0 -keyalg RSA -keysize 2048 -validity 3650 -keystore my_application.p12 -storetype PKCS12 -storepass 123456
n```在交互式提示中，需要輸入以下信息：
- 名字與姓氏（CN）
- 組織單位名稱（OU）
- 組織名稱（O）
- 城市或區域名稱（L）
- 省/市/自治區名稱（ST）
- 國家/地區代碼（C）#### 2.3.2 配置簽名信息在項目的`build-profile.json5`文件中配置簽名信息：```json
{"app": {"signingConfigs": [{"name": "release","type": "HarmonyOS","material": {"certpath": "C:/Users/Username/my_application.cer","storePassword": "123456","keyAlias": "key0","keyPassword": "123456","profile": "C:/Users/Username/my_application.p7b","signAlg": "SHA256withECDSA"}}],"compileSdkVersion": 9,"compatibleSdkVersion": 9,"products": [{"name": "default","signingConfig": "release"}]},"modules": [// 模塊配置]
}

2.3.3 使用DevEco Studio簽名應用

在DevEco Studio中，選擇菜單欄的Build > Build Hap(s)/APP(s) > Build APP(s)
在彈出的對話框中，選擇Release模式和之前配置的簽名信息
點擊OK按鈕，開始構建和簽名過程

3. 環境配置與切換

3.1 多環境配置

在實際開發中，通常需要為不同的環境（開發、測試、生產）配置不同的參數，如API地址、日志級別等。

3.1.1 使用配置文件

創建不同環境的配置文件：

// config/dev.ets - 開發環境配置
export default {API_BASE_URL: 'https://dev-api.example.com',LOG_LEVEL: 'DEBUG',ENABLE_MOCK: true
};// config/test.ets - 測試環境配置
export default {API_BASE_URL: 'https://test-api.example.com',LOG_LEVEL: 'INFO',ENABLE_MOCK: false
};// config/prod.ets - 生產環境配置
export default {API_BASE_URL: 'https://api.example.com',LOG_LEVEL: 'ERROR',ENABLE_MOCK: false
};

3.1.2 環境切換機制

創建一個環境管理模塊，用于加載和切換環境配置：

// utils/env.ets
import devConfig from '../config/dev';
import testConfig from '../config/test';
import prodConfig from '../config/prod';// 環境類型
export enum EnvType {DEV = 'dev',TEST = 'test',PROD = 'prod'
}// 當前環境
let currentEnv: EnvType = EnvType.DEV;// 環境配置映射
const configMap = {[EnvType.DEV]: devConfig,[EnvType.TEST]: testConfig,[EnvType.PROD]: prodConfig
};// 獲取當前環境配置
export function getConfig() {return configMap[currentEnv];
}// 設置當前環境
export function setEnv(env: EnvType) {currentEnv = env;
}// 獲取當前環境類型
export function getEnv(): EnvType {return currentEnv;
}

3.1.3 在登錄模塊中使用環境配置

// services/auth.ets
import { getConfig } from '../utils/env';
import http from '@ohos.net.http';// 發送驗證碼
export async function sendVerifyCode(phoneNumber: string): Promise<boolean> {const config = getConfig();const url = `${config.API_BASE_URL}/auth/sendVerifyCode`;// 如果啟用了模擬模式，直接返回成功if (config.ENABLE_MOCK) {return true;}try {const httpRequest = http.createHttp();const response = await httpRequest.request(url, {method: http.RequestMethod.POST,extraData: { phoneNumber },connectTimeout: 60000,readTimeout: 60000});httpRequest.destroy();if (response.responseCode === 200) {const result = JSON.parse(response.result.toString());return result.success;}return false;} catch (error) {console.error(`Failed to send verify code: ${error}`);return false;}
}

3.2 構建變體

使用DevEco Studio的構建變體功能，可以更方便地管理不同環境的構建配置：

在項目的build-profile.json5文件中配置構建變體：

{"app": {// 應用配置},"modules": [{"name": "entry","srcPath": "./entry","targets": [{"name": "default","applyToProducts": ["default"]}],"buildVariants": [{"name": "dev","productFlavors": [{"name": "flavor1","value": "dev"}]},{"name": "test","productFlavors": [{"name": "flavor1","value": "test"}]},{"name": "prod","productFlavors": [{"name": "flavor1","value": "prod"}]}]}]
}

在代碼中獲取當前構建變體：

import bundleManager from '@ohos.bundle.bundleManager';// 獲取當前構建變體
async function getBuildVariant(): Promise<string> {try {const bundleInfo = await bundleManager.getBundleInfoForSelf(bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_METADATA);const metadata = bundleInfo.metadata;return metadata['flavor1'] || 'dev'; // 默認為dev} catch (error) {console.error(`Failed to get build variant: ${error}`);return 'dev'; // 默認為dev}
}// 根據構建變體設置環境
async function initEnv() {const variant = await getBuildVariant();switch (variant) {case 'dev':setEnv(EnvType.DEV);break;case 'test':setEnv(EnvType.TEST);break;case 'prod':setEnv(EnvType.PROD);break;default:setEnv(EnvType.DEV);}
}

4. 版本管理

4.1 版本號規范

HarmonyOS NEXT應用的版本號由兩部分組成：

版本名稱（versionName）：用于向用戶展示的版本號，通常采用語義化版本號格式（主版本號.次版本號.修訂號）
版本號（versionCode）：用于系統識別的整數版本號，每次更新都應該遞增

在項目的module.json5文件中配置版本信息：

{"module": {"name": "entry","type": "entry","description": "$string:module_desc","mainElement": "EntryAbility","deviceTypes": ["phone","tablet"],"deliveryWithInstall": true,"installationFree": false,"pages": "$profile:main_pages","abilities": [{"name": "EntryAbility","srcEntry": "./ets/entryability/EntryAbility.ets","description": "$string:EntryAbility_desc","icon": "$media:icon","label": "$string:EntryAbility_label","startWindowIcon": "$media:icon","startWindowBackground": "$color:start_window_background","skills": [{"entities": ["entity.system.home"],"actions": ["action.system.home"]}]}],"requestPermissions": [{"name": "ohos.permission.INTERNET"}]},"app": {"bundleName": "com.example.myapplication","vendor": "example","versionCode": 1000000,"versionName": "1.0.0"}
}

4.2 版本更新策略

在更新應用時，應遵循以下版本更新策略：

主版本號：當進行不兼容的API更改時遞增
次版本號：當添加向下兼容的功能時遞增
修訂號：當進行向下兼容的問題修復時遞增
版本號（versionCode）：每次發布都遞增，建議使用格式：主版本號×1000000 + 次版本號×1000 + 修訂號

4.3 版本更新檢測

在應用中實現版本更新檢測功能，提醒用戶更新到最新版本：

// services/update.ets
import http from '@ohos.net.http';
import promptAction from '@ohos.promptAction';
import bundleManager from '@ohos.bundle.bundleManager';// 檢查更新
export async function checkUpdate(): Promise<void> {try {// 獲取當前應用版本信息const bundleInfo = await bundleManager.getBundleInfoForSelf(bundleManager.BundleFlag.GET_BUNDLE_INFO_DEFAULT);const currentVersionCode = bundleInfo.versionCode;const currentVersionName = bundleInfo.versionName;// 從服務器獲取最新版本信息const httpRequest = http.createHttp();const response = await httpRequest.request('https://api.example.com/app/version', {method: http.RequestMethod.GET,connectTimeout: 60000,readTimeout: 60000});httpRequest.destroy();if (response.responseCode === 200) {const result = JSON.parse(response.result.toString());const latestVersionCode = result.versionCode;const latestVersionName = result.versionName;const updateUrl = result.updateUrl;const updateDescription = result.description;// 檢查是否需要更新if (latestVersionCode > currentVersionCode) {// 顯示更新提示promptAction.showDialog({title: '發現新版本',message: `當前版本：${currentVersionName}\n最新版本：${latestVersionName}\n\n${updateDescription}`,buttons: [{text: '稍后再說',color: '#666666'},{text: '立即更新',color: '#0000ff'}],success: (result) => {if (result.index === 1) {// 用戶點擊了立即更新，跳轉到更新頁面或應用市場// 實際實現可能需要調用系統API打開瀏覽器或應用市場console.info(`Update URL: ${updateUrl}`);}}});} else {console.info('當前已是最新版本');}}} catch (error) {console.error(`Failed to check update: ${error}`);}
}

5. 應用市場發布

5.1 華為應用市場發布流程

將應用發布到華為應用市場（AppGallery）的主要步驟：

注冊開發者賬號：在華為開發者聯盟注冊開發者賬號
創建應用：在華為開發者聯盟控制臺創建應用
上傳應用包：上傳簽名后的HAP包
填寫應用信息：填寫應用名稱、描述、分類、標簽、截圖等信息
設置定價和發布范圍：設置應用的定價策略和發布國家/地區
提交審核：提交應用進行審核
發布應用：審核通過后發布應用

5.2 應用發布前的檢查清單

在發布應用前，應進行以下檢查：

功能完整性：確保所有功能正常工作
兼容性：在不同設備和系統版本上測試
性能：檢查應用的啟動時間、響應速度、內存占用等
安全性：確保敏感數據加密、網絡通信安全等
隱私合規：檢查隱私政策是否完整，權限申請是否合理
資源完整：確保所有圖片、文本等資源文件完整
版本信息：檢查版本號是否正確
簽名驗證：確保應用已正確簽名

5.3 灰度發布策略

灰度發布是一種將新版本逐步推廣給用戶的策略，可以降低風險：

階段性發布：先發布給小部分用戶，逐步擴大發布范圍
用戶分組：根據用戶特征（如地區、設備類型）進行分組發布
監控反饋：密切監控用戶反饋和應用性能
快速響應：發現問題時能夠快速響應和修復

在華為應用市場中，可以通過以下方式實現灰度發布：

在發布新版本時，選擇"分階段發布"選項
設置每個階段的用戶比例和時間間隔
根據每個階段的反饋情況，決定是否繼續推進或回滾

6. 登錄模塊的部署注意事項

6.1 服務端接口對接

登錄模塊需要與服務端接口對接，確保通信正常：

接口文檔：明確接口的URL、參數、返回值等
錯誤處理：處理各種可能的錯誤情況
超時設置：設置合理的超時時間
重試機制：實現請求失敗后的重試機制

// services/auth.ets
import http from '@ohos.net.http';
import { getConfig } from '../utils/env';// 登錄接口
export async function login(phoneNumber: string, verifyCode: string): Promise<any> {const config = getConfig();const url = `${config.API_BASE_URL}/auth/login`;try {const httpRequest = http.createHttp();const response = await httpRequest.request(url, {method: http.RequestMethod.POST,extraData: {phoneNumber,verifyCode},connectTimeout: 30000,readTimeout: 30000});httpRequest.destroy();if (response.responseCode === 200) {return JSON.parse(response.result.toString());}throw new Error(`Login failed with code: ${response.responseCode}`);} catch (error) {console.error(`Login error: ${error}`);// 實現重試邏輯return await retryLogin(phoneNumber, verifyCode);}
}// 重試登錄
async function retryLogin(phoneNumber: string, verifyCode: string, maxRetries = 3): Promise<any> {let retries = 0;let lastError;while (retries < maxRetries) {try {const config = getConfig();const url = `${config.API_BASE_URL}/auth/login`;const httpRequest = http.createHttp();const response = await httpRequest.request(url, {method: http.RequestMethod.POST,extraData: {phoneNumber,verifyCode},connectTimeout: 30000,readTimeout: 30000});httpRequest.destroy();if (response.responseCode === 200) {return JSON.parse(response.result.toString());}throw new Error(`Login failed with code: ${response.responseCode}`);} catch (error) {lastError = error;retries++;// 等待一段時間后重試await new Promise(resolve => setTimeout(resolve, 1000 * retries));}}throw lastError;
}

6.2 用戶數據遷移

在更新應用時，可能需要遷移用戶數據：

數據備份：在更新前備份用戶數據
數據遷移：實現數據格式轉換和遷移邏輯
兼容處理：處理新舊版本數據格式不兼容的情況

// utils/dataMigration.ets
import data_preferences from '@ohos.data.preferences';// 數據遷移
export async function migrateUserData(): Promise<void> {try {const context = getContext(this);const oldPreferences = await data_preferences.getPreferences(context, 'user_data_v1');const newPreferences = await data_preferences.getPreferences(context, 'user_data_v2');// 檢查是否需要遷移const migrated = await newPreferences.get('data_migrated', false);if (migrated) {return; // 已經遷移過，無需再次遷移}// 獲取舊數據const userId = await oldPreferences.get('userId', '');const token = await oldPreferences.get('token', '');const loginTime = await oldPreferences.get('loginTime', 0);// 遷移到新格式if (userId) {await newPreferences.put('user_id', userId); // 新的鍵名格式await newPreferences.put('auth_token', token); // 新的鍵名格式await newPreferences.put('last_login_timestamp', loginTime); // 新的鍵名格式// 標記為已遷移await newPreferences.put('data_migrated', true);await newPreferences.flush();console.info('User data migration completed');}} catch (error) {console.error(`Data migration failed: ${error}`);}
}