HarmonyOS應用開發

引言

本章將深入探討 HarmonyOS 應用開發的關鍵方面，包括應用的生命週期、資料儲存和網路存取。瞭解這些內容對於建立功能豐富、高效的 HarmonyOS 應用至關重要。

1. HarmonyOS 應用的生命週期

在 HarmonyOS 應用開發中，瞭解應用的生命週期非常重要，因為它決定了應用在不同狀態下的行為和操作。HarmonyOS 應用的生命週期通常包括以下階段和事件：

1.1 建立階段（Create）

在建立階段，應用被初始化並準備好啟動。這個階段通常用於執行一次性的設定和初始化工作。以下是一些常見的建立階段操作：

初始化應用狀態： 在這個階段，你可以初始化應用的狀態、變數和屬性。

app.onCreate = function() {
  // 初始化應用狀態
  this.counter = 0;
};

建立介面： 你可以在建立階段建立應用的使用者介面，例如設定初始檢視。

app.onCreate = function() {
  // 建立使用者介面
  this.createUI();
};

1.2 啟動階段（Start）

啟動階段表示應用已經啟動並進入了活動狀態。使用者可以與應用進行互動，應用可以響應使用者的操作。

事件處理： 在啟動階段，你可以監聽使用者事件，例如點選按鈕、滑動螢幕等，然後執行相應的操作。

app.onStart = function() {
  // 監聽按鈕點選事件
  button.addEventListener('click', function() {
    this.counter++;
    updateCounterDisplay();
  });
};

1.3 暫停階段（Pause）

暫停階段表示應用失去了焦點，但仍然可見。使用者可以看到應用的介面，但無法進行互動。這個階段通常用於執行一些輕量級的操作。

儲存應用狀態： 在暫停階段，你可以儲存應用的狀態，以便在後續的啟動時恢復。

app.onPause = function() {
  // 儲存應用狀態
  this.saveAppState();
};

1.4 停止階段（Stop）

停止階段表示應用不再可見，通常因為使用者切換到其他應用或將應用最小化。在這個階段，你可以釋放資源和儲存應用狀態。

釋放資源： 你可以關閉資料庫連線、停止後臺任務等，以釋放資源。

app.onStop = function() {
  // 關閉資料庫連線
  database.close();
};

1.5 銷燬階段（Destroy）

銷燬階段表示應用被銷燬，通常是使用者手動關閉應用或作業系統終止應用。在這個階段，你可以進行一些清理操作。

清理資源： 你可以關閉檔案控制程式碼、停止定時器等，以確保資源得到正確釋放。

app.onDestroy = function() {
  // 清理資源
  this.cleanup();
};

瞭解 HarmonyOS 應用的生命週期是編寫高效應用的關鍵。你可以根據每個生命週期階段的事件來執行必要的操作，以確保應用在不同狀態下正常執行並提供良好的使用者體驗。

2. HarmonyOS 應用的資料儲存

在 HarmonyOS 應用開發中，資料儲存是一個關鍵的主題，因為它涉及到如何管理和儲存應用中的資料，包括使用者資料、應用設定以及其他資訊。HarmonyOS 提供了多種方式來進行資料儲存，以下是其中一些詳細解釋：

2.1 資料庫儲存

資料庫儲存適用於結構化資料的儲存和管理，通常用於儲存使用者資訊、應用設定和其他複雜的資料集。在 HarmonyOS 中，你可以使用 SQLite 資料庫或其他資料庫引擎來進行資料庫儲存。

使用 SQLite 資料庫
SQLite 是一種輕量級嵌入式資料庫，適用於移動應用。在 HarmonyOS 中，你可以使用 @system.sqlite 模組來存取 SQLite 資料庫。以下是使用 SQLite 資料庫的範例：

// 匯入 SQLite 模組
import sqlite from '@system.sqlite';

// 開啟或建立資料庫
const database = sqlite.openDatabase({
  name: 'myDatabase',
  version: 1,
  createFromLocation: '/data/mydb.db', // 資料庫檔案路徑
  onOpen(db) {
    // 資料庫開啟時的操作
  },
});

// 執行 SQL 查詢
const results = database.executeSql('SELECT * FROM users');

// 處理查詢結果
for (let i = 0; i < results.rows.length; i++) {
  const row = results.rows.item(i);
  console.log('User:', row.username, 'Email:', row.email);
}

2.2. 檔案儲存

檔案儲存用於儲存應用生成的檔案、快取資料等非結構化資料。HarmonyOS 提供了檔案系統 API，允許你在檔案系統中建立、讀取和寫入檔案。

檔案讀寫範例

// 匯入檔案系統模組
import fileSystem from '@system.file';

// 建立檔案物件
const file = fileSystem.createFile({
  filePath: '/mnt/sdcard/myfile.txt', // 檔案路徑
});

// 寫入檔案
file.writeText('Hello, World!')
  .then(() => {
    console.log('檔案寫入成功');
  })
  .catch((error) => {
    console.error('檔案寫入失敗', error);
  });

// 讀取檔案
file.readText()
  .then((content) => {
    console.log('檔案內容:', content);
  })
  .catch((error) => {
    console.error('檔案讀取失敗', error);
  });

2.3. SharedPreferences

SharedPreferences 是一種輕量級的資料儲存方式，適用於儲存簡單的鍵值對資料，通常用於儲存應用的設定和設定資訊。在 HarmonyOS 中，你可以使用 @system.settings 模組來存取 SharedPreferences。

使用 SharedPreferences 範例

// 匯入設定模組
import settings from '@system.settings';

// 設定和獲取鍵值對
settings.set('theme', 'dark');
const theme = settings.get('theme', 'light');
console.log('當前主題:', theme);

2.4. 資料庫 ORM（物件關係對映）

在使用資料庫儲存時，你還可以考慮使用資料庫 ORM 框架，例如 LiteORM，來簡化資料庫操作。ORM 框架允許你使用物件模型來處理資料庫，而不需要編寫原生的 SQL 查詢。

使用 LiteORM 範例：

// 匯入 LiteORM 模組
import liteOrm from '@system.database.liteorm';

// 定義資料模型
class User {
  @PrimaryKey()
  id;
  
  @Column()
  username;

  @Column()
  email;
}

// 初始化資料庫
const database = liteOrm.openDatabase({
  name: 'myDatabase',
  version: 1,
});

// 建立或更新資料
const user = new User();
user.username = 'john_doe';
user.email = '[email protected]';
database.save(user);

// 查詢資料
const users = database.query(User).find();
console.log('所有使用者:', users);

HarmonyOS 提供了多種資料儲存選項，你可以根據應用的需求選擇合適的方式來管理資料。無論是資料庫儲存、檔案儲存還是 SharedPreferences，都能幫助你有效地處理應用中的資料。根據具體的場景和資料型別選擇適當的資料儲存方法是良好的應用設計實踐。

3. HarmonyOS 應用的網路存取

HarmonyOS 應用的網路存取是實現應用與遠端伺服器通訊、獲取資料和更新內容的重要部分。網路存取在現代應用開發中至關重要，因為它使應用能夠與網際網路上的資源進行互動。以下是詳細解釋 HarmonyOS 應用的網路存取的關鍵概念和範例：

3.1 HTTP 請求

HTTP 請求是與遠端伺服器通訊的標準方法之一。你可以使用 HTTP 請求庫來傳送 GET、POST 和其他型別的 HTTP 請求，與伺服器進行資料交換。

使用 Fetch API 範例

HarmonyOS 提供了 @system.fetch 模組，用於發起 HTTP 請求。

// 匯入 Fetch 模組
import fetch from '@system.fetch';

// 傳送 GET 請求
fetch({
  url: 'https://api.example.com/data',
  method: 'GET',
  success(response) {
    // 處理響應資料
    console.log('響應資料:', response.data);
  },
  fail(error) {
    // 處理錯誤
    console.error('請求失敗:', error);
  },
});

使用 Axios 範例

你還可以使用第三方 HTTP 請求庫，如 Axios，來進行網路請求。首先，需要安裝 Axios 庫：

npm install axios
然後，在應用中使用 Axios：

javascript
Copy code
// 匯入 Axios 模組
import axios from 'axios';

// 傳送 GET 請求
axios.get('https://api.example.com/data')
  .then(response => {
    // 處理響應資料
    console.log('響應資料:', response.data);
  })
  .catch(error => {
    // 處理錯誤
    console.error('請求失敗:', error);
  });

3.2 WebSocket

WebSocket 是一種雙向通訊協定，用於建立永續性連線，實時傳輸資料。它通常用於實現實時聊天、多人遊戲和其他需要實時更新的應用場景。

使用 WebSocket 範例

// 匯入 WebSocket 模組
import WebSocket from '@system.websocket';

// 建立 WebSocket 連線
const ws = new WebSocket('wss://api.example.com/socket');

// 監聽訊息事件
ws.onmessage = function(event) {
  // 處理收到的訊息
  console.log('收到訊息:', event.data);
};

// 傳送訊息
ws.send('Hello, Server!');

3.3 Restful API

HarmonyOS 應用可以使用 Restful API 與伺服器進行通訊。RESTful API 是一種基於 HTTP 協定的 API 設計風格，用於存取和管理資源。你可以使用 @system.request 模組或第三方 HTTP 請求庫來傳送 RESTful API 請求。

使用 @system.request 範例

// 匯入請求模組
import request from '@system.request';

// 傳送 GET 請求
request.get({
  url: 'https://api.example.com/resource',
  success(response) {
    // 處理響應資料
    console.log('響應資料:', response.data);
  },
  fail(error) {
    // 處理錯誤
    console.error('請求失敗:', error);
  },
});

以上是 HarmonyOS 應用中進行網路存取的基本範例。根據你的應用需求，你可以選擇合適的網路存取方法。無論是使用 Fetch API、Axios、WebSocket 還是 Restful API，都能幫助你實現與遠端伺服器的通訊，獲取和更新資料，以及實現實時互動功能。確保處理網路請求時考慮到錯誤處理、非同步操作和資料安全性，以提供穩定和可靠的使用者體驗。

4. 總結

本章詳細介紹了 HarmonyOS 應用開發的關鍵方面，包括應用的生命週期、資料儲存和網路存取。瞭解這些內容對於建立功能豐富、高效的 HarmonyOS 應用至關重要。通過充分利用生命週期、資料儲存和網路存取功能，你可以構建出令使用者滿意的應用程式。

引言

目錄