@simplysm/capacitor-plugin-auto-update 13.0.68 → 13.0.70

package/README.md

@@ -1,211 +1,28 @@
 # @simplysm/capacitor-plugin-auto-update
 
-A Capacitor plugin that supports automatic updates for Android apps. It provides the complete update flow including checking the latest APK version from the server, downloading, and installing it. It also supports updates through APK files on external storage.
-
-## Supported Platforms
-
-| Platform | Supported | Notes |
-|--------|-----------|------|
-| Android | Yes | API 23+ (minSdk 23), compileSdk 35 |
-| Web | Partial | Fallback implementation provided (alert notification, permission checks skipped) |
-| iOS | No | Not supported |
+Simplysm Package - Capacitor Auto Update Plugin
 
 ## Installation
 
-```bash
 pnpm add @simplysm/capacitor-plugin-auto-update
-```
-
-## Android Configuration
-
-### AndroidManifest.xml
-
-The plugin requires `REQUEST_INSTALL_PACKAGES` permission for APK installation. This is already declared in the plugin's manifest, so you don't need to add it separately in your app.
-
-```xml
-<uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES" />
-```
-
-### Capacitor Plugin Registration
-
-The plugin is automatically registered in `capacitor.config.ts` or in the Android project. The Android source path is specified in the `capacitor` field of `package.json`.
-
-## Main Modules
-
-This package exports two main classes.
-
-### ApkInstaller
-
-A low-level API responsible for APK installation and permission management. All methods are `static`.
-
-| Method | Return Type | Description |
-|--------|-----------|------|
-| `hasPermissionManifest()` | `Promise<boolean>` | Check if `REQUEST_INSTALL_PACKAGES` permission is declared in AndroidManifest.xml |
-| `hasPermission()` | `Promise<boolean>` | Check if `REQUEST_INSTALL_PACKAGES` permission is currently granted |
-| `requestPermission()` | `Promise<void>` | Request installation permission (navigates to Android settings screen) |
-| `install(apkUri)` | `Promise<void>` | Execute APK installation. `apkUri` is a `content://` URI (FileProvider URI) |
-| `getVersionInfo()` | `Promise<IVersionInfo>` | Retrieve current app version information |
-
-### IVersionInfo
-
-An interface representing app version information.
-
-| Property | Type | Description |
-|------|------|------|
-| `versionName` | `string` | App version name (e.g., `"1.2.3"`) |
-| `versionCode` | `string` | App version code (integer represented as string) |
-
-### IApkInstallerPlugin
-
-Capacitor native plugin interface. Generally used indirectly through the `ApkInstaller` class.
-
-| Method | Return Type | Description |
-|--------|-----------|------|
-| `install(options)` | `Promise<void>` | Install APK specified in `options.uri` |
-| `hasPermission()` | `Promise<{ granted: boolean }>` | Check installation permission |
-| `requestPermission()` | `Promise<void>` | Request installation permission |
-| `hasPermissionManifest()` | `Promise<{ declared: boolean }>` | Check manifest permission declaration |
-| `getVersionInfo()` | `Promise<IVersionInfo>` | Retrieve version information |
-
-### AutoUpdate
-
-A high-level API that manages the complete automatic update flow. All methods are `static`.
-
-| Method | Return Type | Description |
-|--------|-----------|------|
-| `run(opt)` | `Promise<void>` | Execute server-based automatic update |
-| `runByExternalStorage(opt)` | `Promise<void>` | Execute external storage-based automatic update |
-
-## Usage Examples
-
-### Server-Based Automatic Update
-
-The most common usage method for checking and updating to the latest APK deployed on the server. It connects to the server's `AutoUpdateService` through `ServiceClient` to retrieve the latest version information.
-
-```typescript
-import { AutoUpdate } from "@simplysm/capacitor-plugin-auto-update";
-import { createServiceClient } from "@simplysm/service-client";
-
-const serviceClient = createServiceClient("my-app", {
-  host: "your-server.example.com",
-  port: 443,
-  ssl: true,
-});
-
-await AutoUpdate.run({
-  log: (messageHtml: string) => {
-    // Display update progress in UI
-    document.getElementById("update-status")!.innerHTML = messageHtml;
-  },
-  serviceClient,
-});
-```
-
-Internal flow of the `run` method:
-
-1. Call server's `AutoUpdateService.getLastVersion("android")` to check latest version
-2. Check and request `REQUEST_INSTALL_PACKAGES` permission (wait up to 5 minutes)
-3. Compare current app version with server version using semver
-4. Download APK if server version is higher (provides progress callback)
-5. Save APK file to app cache and execute installation intent
-6. Freeze app after installation (encourage user to restart)
-
-### External Storage-Based Update
-
-A method for updating using an APK file pre-placed on external storage (e.g., USB, SD card) without network connectivity. The APK filename must be in semver format (e.g., `1.2.3.apk`).
-
-```typescript
-import { AutoUpdate } from "@simplysm/capacitor-plugin-auto-update";
-
-await AutoUpdate.runByExternalStorage({
-  log: (messageHtml: string) => {
-    document.getElementById("update-status")!.innerHTML = messageHtml;
-  },
-  dirPath: "MyApp/updates",
-});
-```
-
-Internal flow of the `runByExternalStorage` method:
-
-1. Check and request `REQUEST_INSTALL_PACKAGES` permission
-2. Retrieve `.apk` file list from specified directory in external storage
-3. Extract version from filenames and determine latest version using semver
-4. Compare with current app version and execute installation if latest version
-
-### Direct Use of ApkInstaller
-
-Use `ApkInstaller` when you need to directly control the update flow.
-
-```typescript
-import { ApkInstaller } from "@simplysm/capacitor-plugin-auto-update";
-
-// Check current app version
-const versionInfo = await ApkInstaller.getVersionInfo();
-console.log(`Current version: ${versionInfo.versionName} (${versionInfo.versionCode})`);
-
-// Check and request permission
-const hasManifest = await ApkInstaller.hasPermissionManifest();
-if (!hasManifest) {
-  throw new Error("REQUEST_INSTALL_PACKAGES permission is not declared in AndroidManifest.xml.");
-}
-
-const hasPermission = await ApkInstaller.hasPermission();
-if (!hasPermission) {
-  await ApkInstaller.requestPermission();
-  // Need to wait until user grants permission in settings screen
-}
-
-// Install APK (requires content:// URI)
-await ApkInstaller.install("content://com.example.fileprovider/apk/update.apk");
-```
-
-## Web Environment Behavior
-
-When running in a web browser, the `ApkInstallerWeb` fallback is automatically used.
-
-| Method | Web Behavior |
-|--------|---------|
-| `install()` | Show alert about unsupported feature then return normally |
-| `hasPermission()` | Always return `{ granted: true }` |
-| `requestPermission()` | No operation (no-op) |
-| `hasPermissionManifest()` | Always return `{ declared: true }` |
-| `getVersionInfo()` | Return `import.meta.env.__VER__` value as `versionName` (or `"0.0.0"` if not available) |
-
-## Server-Side Requirements
-
-To use the `AutoUpdate.run()` method, the server must implement the `AutoUpdateService` interface.
-
-```typescript
-interface AutoUpdateService {
-  getLastVersion(platform: string): Promise<
-    | { version: string; downloadPath: string }
-    | undefined
-  >;
-}
-```
 
-- `platform`: The string `"android"` is passed
-- `version`: Version string in semver format (e.g., `"1.2.3"`)
-- `downloadPath`: Download path for the APK file (combined with server host URL)
+**Peer Dependencies:** `@capacitor/core ^7.4.4`
 
-## Dependencies
+## Source Index
 
-### Peer Dependencies
+### APK Installer
 
-| Package | Version |
-|--------|------|
-| `@capacitor/core` | `^7.4.4` |
+| Source | Exports | Description | Test |
+|--------|---------|-------------|------|
+| `src/ApkInstaller.ts` | `ApkInstaller` | Static class to check/request install permission and trigger APK installation | - |
+| `src/IApkInstallerPlugin.ts` | `IVersionInfo`, `IApkInstallerPlugin` | Interfaces for app version info and the native APK installer plugin contract | - |
 
-### Internal Dependencies
+### Auto Update
 
-| Package | Purpose |
-|--------|------|
-| `@simplysm/core-common` | Path utilities, HTML templates, `waitUntil`, etc. |
-| `@simplysm/core-browser` | `fetchUrlBytes` (file download) |
-| `@simplysm/capacitor-plugin-file-system` | File read/write, URI conversion, storage paths |
-| `@simplysm/service-client` | `ServiceClient` (server communication) |
-| `@simplysm/service-common` | `AutoUpdateService` interface definition |
+| Source | Exports | Description | Test |
+|--------|---------|-------------|------|
+| `src/AutoUpdate.ts` | `AutoUpdate` | Downloads and installs the latest APK from a server or external storage | - |
 
 ## License
 
-MIT
+Apache-2.0

package/dist/ApkInstaller.d.ts

@@ -1,29 +1,29 @@
 import type { IVersionInfo } from "./IApkInstallerPlugin";
 /**
- * APK 설치 플러그인
- * - Android: APK 설치 인텐트 실행, REQUEST_INSTALL_PACKAGES 권한 관리
- * - Browser: alert으로 안내 후 정상 반환
+ * APK installation plugin
+ * - Android: Executes APK install intent, manages REQUEST_INSTALL_PACKAGES permission
+ * - Browser: Shows alert message and returns normally
  */
 export declare abstract class ApkInstaller {
     /**
-     * Manifest에 REQUEST_INSTALL_PACKAGES 권한이 선언되어 있는지 확인
+     * Check if REQUEST_INSTALL_PACKAGES permission is declared in the manifest
      */
     static hasPermissionManifest(): Promise<boolean>;
     /**
-     * REQUEST_INSTALL_PACKAGES 권한이 허용되어 있는지 확인
+     * Check if REQUEST_INSTALL_PACKAGES permission is granted
      */
     static hasPermission(): Promise<boolean>;
     /**
-     * REQUEST_INSTALL_PACKAGES 권한 요청 (설정 화면으로 이동)
+     * Request REQUEST_INSTALL_PACKAGES permission (navigates to settings)
      */
     static requestPermission(): Promise<void>;
     /**
-     * APK 설치
+     * Install APK
      * @param apkUri content:// URI (FileProvider URI)
      */
     static install(apkUri: string): Promise<void>;
     /**
-     * 앱 버전 정보 가져오기
+     * Get app version info
      */
     static getVersionInfo(): Promise<IVersionInfo>;
 }

package/dist/ApkInstaller.js

@@ -7,34 +7,34 @@ const ApkInstallerPlugin = registerPlugin("ApkInstaller", {
 });
 class ApkInstaller {
   /**
-   * Manifest에 REQUEST_INSTALL_PACKAGES 권한이 선언되어 있는지 확인
+   * Check if REQUEST_INSTALL_PACKAGES permission is declared in the manifest
    */
   static async hasPermissionManifest() {
     const result = await ApkInstallerPlugin.hasPermissionManifest();
     return result.declared;
   }
   /**
-   * REQUEST_INSTALL_PACKAGES 권한이 허용되어 있는지 확인
+   * Check if REQUEST_INSTALL_PACKAGES permission is granted
    */
   static async hasPermission() {
     const result = await ApkInstallerPlugin.hasPermission();
     return result.granted;
   }
   /**
-   * REQUEST_INSTALL_PACKAGES 권한 요청 (설정 화면으로 이동)
+   * Request REQUEST_INSTALL_PACKAGES permission (navigates to settings)
    */
   static async requestPermission() {
     await ApkInstallerPlugin.requestPermission();
   }
   /**
-   * APK 설치
+   * Install APK
    * @param apkUri content:// URI (FileProvider URI)
    */
   static async install(apkUri) {
     await ApkInstallerPlugin.install({ uri: apkUri });
   }
   /**
-   * 앱 버전 정보 가져오기
+   * Get app version info
    */
   static async getVersionInfo() {
     return ApkInstallerPlugin.getVersionInfo();

package/dist/AutoUpdate.js

@@ -29,34 +29,34 @@ class AutoUpdate {
               class="_button"
               href="intent://${targetHref.replace(/^https?:\/\//, "")}#Intent;scheme=http;end"
             >
-              다운로드
+              Download
             </a>
           ` : "";
     throw new Error(html`
-      APK파일을 다시 다운로드 받아, 설치해야 합니다(${code}). ${downloadHtml}
+      You need to re-download and install the APK file(${code}). ${downloadHtml}
     `);
   }
   static async _checkPermission(log, targetHref) {
     if (!navigator.userAgent.toLowerCase().includes("android")) {
-      throw new Error("\uC548\uB4DC\uB85C\uC774\uB4DC\uB9CC \uC9C0\uC6D0\uD569\uB2C8\uB2E4.");
+      throw new Error("Only Android is supported.");
     }
     try {
       if (!await ApkInstaller.hasPermissionManifest()) {
         this._throwAboutReinstall(1, targetHref);
       }
     } catch (err) {
-      console.error("[AutoUpdate] hasPermissionManifest \uCCB4\uD06C \uC2E4\uD328:", err);
+      console.error("[AutoUpdate] hasPermissionManifest check failed:", err);
       this._throwAboutReinstall(2, targetHref);
     }
     const hasPerm = await ApkInstaller.hasPermission();
     if (!hasPerm) {
       log(html`
-        설치권한이 설정되어야합니다.
+        Installation permission must be enabled.
         <style>
           button { ${this._BUTTON_CSS} }
           button:active { ${this._BUTTON_ACTIVE_CSS} }
         </style>
-        <button onclick="location.reload()">재시도</button>
+        <button onclick="location.reload()">Retry</button>
       `);
       await ApkInstaller.requestPermission();
       await waitUntil(
@@ -70,19 +70,19 @@ class AutoUpdate {
   }
   static async _installApk(log, apkFilePath) {
     log(html`
-      최신버전을 설치한 후 재시작하세요.
+      Please install the latest version and restart.
       <style>
         button { ${this._BUTTON_CSS} }
         button:active { ${this._BUTTON_ACTIVE_CSS} }
       </style>
-      <button onclick="location.reload()">재시도</button>
+      <button onclick="location.reload()">Retry</button>
     `);
     const apkFileUri = await FileSystem.getFileUri(apkFilePath);
     await ApkInstaller.install(apkFileUri);
   }
   static _getErrorMessage(err) {
     return html`
-      업데이트 중 오류 발생:
+      Error occurred during update:
       <br />
       ${err instanceof Error ? err.message : String(err)}
     `;
@@ -93,14 +93,14 @@ class AutoUpdate {
   }
   static async run(opt) {
     try {
-      opt.log(`\uCD5C\uC2E0\uBC84\uC804 \uD655\uC778 \uC911...`);
+      opt.log(`Checking latest version...`);
       const autoUpdateServiceClient = opt.serviceClient.getService("AutoUpdateService");
       const serverVersionInfo = await autoUpdateServiceClient.getLastVersion("android");
       if (!serverVersionInfo) {
-        console.log("\uC11C\uBC84\uC5D0\uC11C \uCD5C\uC2E0\uBC84\uC804 \uC815\uBCF4\uB97C \uAC00\uC838\uC624\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4.");
+        console.log("Failed to get latest version information from server.");
         return;
       }
-      opt.log(`\uAD8C\uD55C \uD655\uC778 \uC911...`);
+      opt.log(`Checking permission...`);
       await this._checkPermission(
         opt.log,
         opt.serviceClient.hostUrl + serverVersionInfo.downloadPath
@@ -113,7 +113,7 @@ class AutoUpdate {
       if (!semver.gt(serverVersionInfo.version, currentVersionInfo.versionName)) {
         return;
       }
-      opt.log(`\uCD5C\uC2E0\uBC84\uC804 \uD30C\uC77C \uB2E4\uC6B4\uB85C\uB4DC\uC911...`);
+      opt.log(`Downloading latest version file...`);
       const buffer = await fetchUrlBytes(
         opt.serviceClient.hostUrl + serverVersionInfo.downloadPath,
         {
@@ -121,7 +121,7 @@ class AutoUpdate {
             const progressText = (progress.receivedLength * 100 / progress.contentLength).toFixed(
               2
             );
-            opt.log(`\uCD5C\uC2E0\uBC84\uC804 \uD30C\uC77C \uB2E4\uC6B4\uB85C\uB4DC\uC911...(${progressText}%)`);
+            opt.log(`Downloading latest version file...(${progressText}%)`);
           }
         }
       );
@@ -137,9 +137,9 @@ class AutoUpdate {
   }
   static async runByExternalStorage(opt) {
     try {
-      opt.log(`\uAD8C\uD55C \uD655\uC778 \uC911...`);
+      opt.log(`Checking permission...`);
       await this._checkPermission(opt.log);
-      opt.log(`\uCD5C\uC2E0\uBC84\uC804 \uD655\uC778 \uC911...`);
+      opt.log(`Checking latest version...`);
       const externalPath = await FileSystem.getStoragePath("external");
       const fileInfos = await FileSystem.readdir(pathJoin(externalPath, opt.dirPath));
       const versions = fileInfos.filter((fileInfo) => !fileInfo.isDirectory).map((fileInfo) => ({
@@ -155,7 +155,7 @@ class AutoUpdate {
         "*"
       );
       if (latestVersion == null) {
-        console.log("\uC720\uD6A8\uD55C semver \uBC84\uC804 \uD30C\uC77C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.");
+        console.log("No valid semver version files found.");
         return;
       }
       const currentVersionInfo = await ApkInstaller.getVersionInfo();

package/dist/AutoUpdate.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../src/AutoUpdate.ts"],
-  "mappings": "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",
+  "mappings": "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",
   "names": []
 }

package/dist/web/ApkInstallerWeb.js

@@ -1,7 +1,7 @@
 import { WebPlugin } from "@capacitor/core";
 class ApkInstallerWeb extends WebPlugin {
   install(_options) {
-    alert("[ApkInstaller] \uC6F9 \uD658\uACBD\uC5D0\uC11C\uB294 APK \uC124\uCE58\uB97C \uC9C0\uC6D0\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.");
+    alert("[ApkInstaller] APK installation is not supported in web environment.");
     return Promise.resolve();
   }
   hasPermission() {

package/dist/web/ApkInstallerWeb.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../src/web/ApkInstallerWeb.ts"],
-  "mappings": "AAAA,SAAS,iBAAiB;AAGnB,MAAM,wBAAwB,UAAyC;AAAA,EAC5E,QAAQ,UAA0C;AAChD,UAAM,gIAA2C;AACjD,WAAO,QAAQ,QAAQ;AAAA,EACzB;AAAA,EAEA,gBAA+C;AAE7C,WAAO,QAAQ,QAAQ,EAAE,SAAS,KAAK,CAAC;AAAA,EAC1C;AAAA,EAEA,MAAM,oBAAmC;AAAA,EAEzC;AAAA,EAEA,wBAAwD;AAEtD,WAAO,QAAQ,QAAQ,EAAE,UAAU,KAAK,CAAC;AAAA,EAC3C;AAAA,EAEA,iBAAwC;AAvB1C;AAwBI,WAAO,QAAQ,QAAQ;AAAA,MACrB,eACG,iBAA4D,QAA5D,mBAAkE,eAAc;AAAA,MACnF,aAAa;AAAA,IACf,CAAC;AAAA,EACH;AACF;",
+  "mappings": "AAAA,SAAS,iBAAiB;AAGnB,MAAM,wBAAwB,UAAyC;AAAA,EAC5E,QAAQ,UAA0C;AAChD,UAAM,sEAAsE;AAC5E,WAAO,QAAQ,QAAQ;AAAA,EACzB;AAAA,EAEA,gBAA+C;AAE7C,WAAO,QAAQ,QAAQ,EAAE,SAAS,KAAK,CAAC;AAAA,EAC1C;AAAA,EAEA,MAAM,oBAAmC;AAAA,EAEzC;AAAA,EAEA,wBAAwD;AAEtD,WAAO,QAAQ,QAAQ,EAAE,UAAU,KAAK,CAAC;AAAA,EAC3C;AAAA,EAEA,iBAAwC;AAvB1C;AAwBI,WAAO,QAAQ,QAAQ;AAAA,MACrB,eACG,iBAA4D,QAA5D,mBAAkE,eAAc;AAAA,MACnF,aAAa;AAAA,IACf,CAAC;AAAA,EACH;AACF;",
   "names": []
 }

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@simplysm/capacitor-plugin-auto-update",
-  "version": "13.0.68",
-  "description": "심플리즘 패키지 - Capacitor Auto Update Plugin",
-  "author": "김석래",
+  "version": "13.0.70",
+  "description": "Simplysm Package - Capacitor Auto Update Plugin",
+  "author": "simplysm",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -14,15 +14,16 @@
   "types": "./dist/index.d.ts",
   "files": [
     "dist",
+    "src",
     "android"
   ],
   "dependencies": {
     "semver": "^7.7.4",
-    "@simplysm/capacitor-plugin-file-system": "13.0.68",
-    "@simplysm/core-browser": "13.0.68",
-    "@simplysm/core-common": "13.0.68",
-    "@simplysm/service-common": "13.0.68",
-    "@simplysm/service-client": "13.0.68"
+    "@simplysm/capacitor-plugin-file-system": "13.0.70",
+    "@simplysm/core-browser": "13.0.70",
+    "@simplysm/core-common": "13.0.70",
+    "@simplysm/service-client": "13.0.70",
+    "@simplysm/service-common": "13.0.70"
   },
   "devDependencies": {
     "@capacitor/core": "^7.5.0",

package/src/ApkInstaller.ts

@@ -0,0 +1,54 @@
+import { registerPlugin } from "@capacitor/core";
+import type { IApkInstallerPlugin, IVersionInfo } from "./IApkInstallerPlugin";
+
+const ApkInstallerPlugin = registerPlugin<IApkInstallerPlugin>("ApkInstaller", {
+  web: async () => {
+    const { ApkInstallerWeb } = await import("./web/ApkInstallerWeb");
+    return new ApkInstallerWeb();
+  },
+});
+
+/**
+ * APK installation plugin
+ * - Android: Executes APK install intent, manages REQUEST_INSTALL_PACKAGES permission
+ * - Browser: Shows alert message and returns normally
+ */
+export abstract class ApkInstaller {
+  /**
+   * Check if REQUEST_INSTALL_PACKAGES permission is declared in the manifest
+   */
+  static async hasPermissionManifest(): Promise<boolean> {
+    const result = await ApkInstallerPlugin.hasPermissionManifest();
+    return result.declared;
+  }
+
+  /**
+   * Check if REQUEST_INSTALL_PACKAGES permission is granted
+   */
+  static async hasPermission(): Promise<boolean> {
+    const result = await ApkInstallerPlugin.hasPermission();
+    return result.granted;
+  }
+
+  /**
+   * Request REQUEST_INSTALL_PACKAGES permission (navigates to settings)
+   */
+  static async requestPermission(): Promise<void> {
+    await ApkInstallerPlugin.requestPermission();
+  }
+
+  /**
+   * Install APK
+   * @param apkUri content:// URI (FileProvider URI)
+   */
+  static async install(apkUri: string): Promise<void> {
+    await ApkInstallerPlugin.install({ uri: apkUri });
+  }
+
+  /**
+   * Get app version info
+   */
+  static async getVersionInfo(): Promise<IVersionInfo> {
+    return ApkInstallerPlugin.getVersionInfo();
+  }
+}

package/src/AutoUpdate.ts

@@ -0,0 +1,236 @@
+import { FileSystem } from "@simplysm/capacitor-plugin-file-system";
+import { html, waitUntil, pathJoin, pathBasename, pathExtname } from "@simplysm/core-common";
+import { fetchUrlBytes } from "@simplysm/core-browser";
+import type { ServiceClient } from "@simplysm/service-client";
+import type { AutoUpdateService } from "@simplysm/service-common";
+import semver from "semver";
+import { ApkInstaller } from "./ApkInstaller";
+
+export abstract class AutoUpdate {
+  private static readonly _BUTTON_CSS = `
+    all: unset;
+    color: blue;
+    width: 100%;
+    padding: 10px;
+    line-height: 1.5em;
+    font-size: 20px;
+    position: fixed;
+    bottom: 0;
+    left: 0;
+    border-top: 1px solid lightgrey;
+  `;
+
+  private static readonly _BUTTON_ACTIVE_CSS = `
+    background: lightgrey;
+  `;
+
+  private static _throwAboutReinstall(code: number, targetHref?: string) {
+    const downloadHtml =
+      targetHref != null
+        ? html`
+            <style>
+              ._button { ${this._BUTTON_CSS} }
+              ._button:active { ${this._BUTTON_ACTIVE_CSS} }
+            </style>
+            <a
+              class="_button"
+              href="intent://${targetHref.replace(/^https?:\/\//, "")}#Intent;scheme=http;end"
+            >
+              Download
+            </a>
+          `
+        : "";
+
+    throw new Error(html`
+      You need to re-download and install the APK file(${code}). ${downloadHtml}
+    `);
+  }
+
+  private static async _checkPermission(log: (messageHtml: string) => void, targetHref?: string) {
+    if (!navigator.userAgent.toLowerCase().includes("android")) {
+      throw new Error("Only Android is supported.");
+    }
+
+    try {
+      if (!(await ApkInstaller.hasPermissionManifest())) {
+        this._throwAboutReinstall(1, targetHref);
+      }
+    } catch (err) {
+      // eslint-disable-next-line no-console
+      console.error("[AutoUpdate] hasPermissionManifest check failed:", err);
+      this._throwAboutReinstall(2, targetHref);
+    }
+
+    const hasPerm = await ApkInstaller.hasPermission();
+    if (!hasPerm) {
+      log(html`
+        Installation permission must be enabled.
+        <style>
+          button { ${this._BUTTON_CSS} }
+          button:active { ${this._BUTTON_ACTIVE_CSS} }
+        </style>
+        <button onclick="location.reload()">Retry</button>
+      `);
+      await ApkInstaller.requestPermission();
+      // Wait up to 5 minutes (300 seconds) - time for user to grant permission in settings
+      await waitUntil(
+        async () => {
+          return ApkInstaller.hasPermission();
+        },
+        1000,
+        300,
+      );
+    }
+  }
+
+  private static async _installApk(
+    log: (messageHtml: string) => void,
+    apkFilePath: string,
+  ): Promise<void> {
+    log(html`
+      Please install the latest version and restart.
+      <style>
+        button { ${this._BUTTON_CSS} }
+        button:active { ${this._BUTTON_ACTIVE_CSS} }
+      </style>
+      <button onclick="location.reload()">Retry</button>
+    `);
+    const apkFileUri = await FileSystem.getFileUri(apkFilePath);
+    await ApkInstaller.install(apkFileUri);
+  }
+
+  private static _getErrorMessage(err: unknown) {
+    return html`
+      Error occurred during update:
+      <br />
+      ${err instanceof Error ? err.message : String(err)}
+    `;
+  }
+
+  private static async _freezeApp() {
+    await new Promise(() => {}); // Wait indefinitely
+  }
+
+  static async run(opt: { log: (messageHtml: string) => void; serviceClient: ServiceClient }) {
+    try {
+      opt.log(`Checking latest version...`);
+
+      // Get version and download link from server
+      const autoUpdateServiceClient =
+        opt.serviceClient.getService<AutoUpdateService>("AutoUpdateService");
+
+      const serverVersionInfo = await autoUpdateServiceClient.getLastVersion("android");
+      if (!serverVersionInfo) {
+        // eslint-disable-next-line no-console
+        console.log("Failed to get latest version information from server.");
+        return;
+      }
+
+      opt.log(`Checking permission...`);
+      await this._checkPermission(
+        opt.log,
+        opt.serviceClient.hostUrl + serverVersionInfo.downloadPath,
+      );
+
+      // Get current app version
+      const currentVersionInfo = await ApkInstaller.getVersionInfo();
+
+      // Return if already latest or server version is lower
+      if (
+        semver.valid(currentVersionInfo.versionName) === null ||
+        semver.valid(serverVersionInfo.version) === null
+      ) {
+        // eslint-disable-next-line no-console
+        console.log("Invalid semver version, skipping update check");
+        return;
+      }
+      if (!semver.gt(serverVersionInfo.version, currentVersionInfo.versionName)) {
+        return;
+      }
+
+      opt.log(`Downloading latest version file...`);
+      const buffer = await fetchUrlBytes(
+        opt.serviceClient.hostUrl + serverVersionInfo.downloadPath,
+        {
+          onProgress: (progress) => {
+            const progressText = ((progress.receivedLength * 100) / progress.contentLength).toFixed(
+              2,
+            );
+            opt.log(`Downloading latest version file...(${progressText}%)`);
+          },
+        },
+      );
+      const storagePath = await FileSystem.getStoragePath("appCache");
+      const apkFilePath = pathJoin(storagePath, `latest.apk`);
+      await FileSystem.writeFile(apkFilePath, buffer);
+
+      await this._installApk(opt.log, apkFilePath);
+      await this._freezeApp();
+    } catch (err) {
+      opt.log(this._getErrorMessage(err));
+      await this._freezeApp();
+    }
+  }
+
+  static async runByExternalStorage(opt: { log: (messageHtml: string) => void; dirPath: string }) {
+    try {
+      opt.log(`Checking permission...`);
+      await this._checkPermission(opt.log);
+
+      opt.log(`Checking latest version...`);
+
+      // Get versions
+      const externalPath = await FileSystem.getStoragePath("external");
+      const fileInfos = await FileSystem.readdir(pathJoin(externalPath, opt.dirPath));
+
+      const versions = fileInfos
+        .filter((fileInfo) => !fileInfo.isDirectory)
+        .map((fileInfo) => ({
+          fileName: fileInfo.name,
+          version: pathBasename(fileInfo.name, pathExtname(fileInfo.name)),
+          extName: pathExtname(fileInfo.name),
+        }))
+        .filter((item) => {
+          return item.extName === ".apk" && /^[0-9.]*$/.test(item.version);
+        });
+
+      // Return if no version files are saved
+      if (versions.length === 0) return;
+
+      const latestVersion = semver.maxSatisfying(
+        versions.map((item) => item.version),
+        "*",
+      );
+
+      // Return if no valid semver versions
+      if (latestVersion == null) {
+        // eslint-disable-next-line no-console
+        console.log("No valid semver version files found.");
+        return;
+      }
+
+      // Get current app version
+      const currentVersionInfo = await ApkInstaller.getVersionInfo();
+
+      // Return if already latest or external storage version is lower
+      if (
+        semver.valid(currentVersionInfo.versionName) === null ||
+        semver.valid(latestVersion) === null
+      ) {
+        // eslint-disable-next-line no-console
+        console.log("Invalid semver version, skipping update check");
+        return;
+      }
+      if (!semver.gt(latestVersion, currentVersionInfo.versionName)) {
+        return;
+      }
+
+      const apkFilePath = pathJoin(externalPath, opt.dirPath, latestVersion + ".apk");
+      await this._installApk(opt.log, apkFilePath);
+      await this._freezeApp();
+    } catch (err) {
+      opt.log(this._getErrorMessage(err));
+      await this._freezeApp();
+    }
+  }
+}

package/src/IApkInstallerPlugin.ts

@@ -0,0 +1,12 @@
+export interface IVersionInfo {
+  versionName: string;
+  versionCode: string;
+}
+
+export interface IApkInstallerPlugin {
+  install(options: { uri: string }): Promise<void>;
+  hasPermission(): Promise<{ granted: boolean }>;
+  requestPermission(): Promise<void>;
+  hasPermissionManifest(): Promise<{ declared: boolean }>;
+  getVersionInfo(): Promise<IVersionInfo>;
+}

package/src/index.ts

@@ -0,0 +1,6 @@
+// APK Installer
+export * from "./ApkInstaller";
+export * from "./IApkInstallerPlugin";
+
+// Auto Update
+export * from "./AutoUpdate";

package/src/web/ApkInstallerWeb.ts

@@ -0,0 +1,31 @@
+import { WebPlugin } from "@capacitor/core";
+import type { IApkInstallerPlugin, IVersionInfo } from "../IApkInstallerPlugin";
+
+export class ApkInstallerWeb extends WebPlugin implements IApkInstallerPlugin {
+  install(_options: { uri: string }): Promise<void> {
+    alert("[ApkInstaller] APK installation is not supported in web environment.");
+    return Promise.resolve();
+  }
+
+  hasPermission(): Promise<{ granted: boolean }> {
+    // Skip permission check on web
+    return Promise.resolve({ granted: true });
+  }
+
+  async requestPermission(): Promise<void> {
+    // No-op on web
+  }
+
+  hasPermissionManifest(): Promise<{ declared: boolean }> {
+    // Skip manifest check on web
+    return Promise.resolve({ declared: true });
+  }
+
+  getVersionInfo(): Promise<IVersionInfo> {
+    return Promise.resolve({
+      versionName:
+        (import.meta as unknown as { env?: Record<string, string> }).env?.["__VER__"] ?? "0.0.0",
+      versionCode: "0",
+    });
+  }
+}