@simplysm/capacitor-plugin-auto-update 12.15.69

package/android/build.gradle

@@ -0,0 +1,9 @@
+apply plugin: 'com.android.library'
+
+android {
+    namespace "kr.co.simplysm.capacitor.apkinstaller"
+}
+
+dependencies {
+    implementation project(':capacitor-android')
+}

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+  <uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES" />
+</manifest>

package/android/src/main/java/kr/co/simplysm/capacitor/apkinstaller/ApkInstallerPlugin.java

@@ -0,0 +1,125 @@
+package kr.co.simplysm.capacitor.apkinstaller;
+
+import android.content.Context;
+import android.content.Intent;
+import android.content.pm.PackageInfo;
+import android.content.pm.PackageManager;
+import android.net.Uri;
+import android.os.Build;
+import android.provider.Settings;
+import android.util.Log;
+
+import com.getcapacitor.JSObject;
+import com.getcapacitor.Plugin;
+import com.getcapacitor.PluginCall;
+import com.getcapacitor.PluginMethod;
+import com.getcapacitor.annotation.CapacitorPlugin;
+
+@CapacitorPlugin(name = "ApkInstaller")
+public class ApkInstallerPlugin extends Plugin {
+
+    private static final String TAG = "ApkInstallerPlugin";
+
+    @PluginMethod
+    public void install(PluginCall call) {
+        String uriStr = call.getString("uri");
+        if (uriStr == null) {
+            call.reject("uri is required");
+            return;
+        }
+
+        try {
+            Uri apkUri = Uri.parse(uriStr);
+
+            Intent intent = new Intent(Intent.ACTION_VIEW);
+            intent.setDataAndType(apkUri, "application/vnd.android.package-archive");
+            intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_GRANT_READ_URI_PERMISSION);
+
+            getContext().startActivity(intent);
+            call.resolve();
+        } catch (Exception e) {
+            Log.e(TAG, "install failed", e);
+            call.reject("Install failed: " + e.getMessage());
+        }
+    }
+
+    @PluginMethod
+    public void hasPermission(PluginCall call) {
+        boolean granted;
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+            granted = getContext().getPackageManager().canRequestPackageInstalls();
+        } else {
+            granted = true;
+        }
+
+        JSObject ret = new JSObject();
+        ret.put("granted", granted);
+        call.resolve(ret);
+    }
+
+    @PluginMethod
+    public void requestPermission(PluginCall call) {
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+            Context context = getContext();
+            Intent intent = new Intent(Settings.ACTION_MANAGE_UNKNOWN_APP_SOURCES);
+            intent.setData(Uri.parse("package:" + context.getPackageName()));
+            intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+            context.startActivity(intent);
+        }
+        call.resolve();
+    }
+
+    @PluginMethod
+    public void hasPermissionManifest(PluginCall call) {
+        try {
+            Context context = getContext();
+            String targetPermission = "android.permission.REQUEST_INSTALL_PACKAGES";
+
+            String[] requestedPermissions = context.getPackageManager()
+                .getPackageInfo(context.getPackageName(), PackageManager.GET_PERMISSIONS)
+                .requestedPermissions;
+
+            boolean declared = false;
+            if (requestedPermissions != null) {
+                for (String perm : requestedPermissions) {
+                    if (targetPermission.equals(perm)) {
+                        declared = true;
+                        break;
+                    }
+                }
+            }
+
+            JSObject ret = new JSObject();
+            ret.put("declared", declared);
+            call.resolve(ret);
+        } catch (Exception e) {
+            Log.e(TAG, "hasPermissionManifest failed", e);
+            call.reject("Manifest check failed: " + e.getMessage());
+        }
+    }
+
+    @PluginMethod
+    public void getVersionInfo(PluginCall call) {
+        try {
+            Context context = getContext();
+            PackageManager pm = context.getPackageManager();
+            PackageInfo info = pm.getPackageInfo(context.getPackageName(), 0);
+
+            String versionName = info.versionName;
+            long versionCode;
+            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
+                versionCode = info.getLongVersionCode();
+            } else {
+                versionCode = info.versionCode;
+            }
+
+            JSObject ret = new JSObject();
+            ret.put("versionName", versionName);
+            ret.put("versionCode", String.valueOf(versionCode));
+            call.resolve(ret);
+        } catch (Exception e) {
+            Log.e(TAG, "getVersionInfo failed", e);
+            call.reject("getVersionInfo failed: " + e.getMessage());
+        }
+    }
+}

package/dist/ApkInstaller.d.ts

@@ -0,0 +1,29 @@
+import { IVersionInfo } from "./IApkInstallerPlugin";
+/**
+ * APK 설치 플러그인
+ * - Android: APK 설치 인텐트 실행, REQUEST_INSTALL_PACKAGES 권한 관리
+ * - Browser: alert으로 안내 후 정상 반환
+ */
+export declare abstract class ApkInstaller {
+    /**
+     * Manifest에 REQUEST_INSTALL_PACKAGES 권한이 선언되어 있는지 확인
+     */
+    static hasPermissionManifest(): Promise<boolean>;
+    /**
+     * REQUEST_INSTALL_PACKAGES 권한이 허용되어 있는지 확인
+     */
+    static hasPermission(): Promise<boolean>;
+    /**
+     * REQUEST_INSTALL_PACKAGES 권한 요청 (설정 화면으로 이동)
+     */
+    static requestPermission(): Promise<void>;
+    /**
+     * APK 설치
+     * @param apkUri content:// URI (FileProvider URI)
+     */
+    static install(apkUri: string): Promise<void>;
+    /**
+     * 앱 버전 정보 가져오기
+     */
+    static getVersionInfo(): Promise<IVersionInfo>;
+}

package/dist/ApkInstaller.js

@@ -0,0 +1,47 @@
+import { registerPlugin } from "@capacitor/core";
+const ApkInstallerPlugin = registerPlugin("ApkInstaller", {
+    web: async () => {
+        const { ApkInstallerWeb } = await import("./web/ApkInstallerWeb");
+        return new ApkInstallerWeb();
+    },
+});
+/**
+ * APK 설치 플러그인
+ * - Android: APK 설치 인텐트 실행, REQUEST_INSTALL_PACKAGES 권한 관리
+ * - Browser: alert으로 안내 후 정상 반환
+ */
+export class ApkInstaller {
+    /**
+     * Manifest에 REQUEST_INSTALL_PACKAGES 권한이 선언되어 있는지 확인
+     */
+    static async hasPermissionManifest() {
+        const result = await ApkInstallerPlugin.hasPermissionManifest();
+        return result.declared;
+    }
+    /**
+     * REQUEST_INSTALL_PACKAGES 권한이 허용되어 있는지 확인
+     */
+    static async hasPermission() {
+        const result = await ApkInstallerPlugin.hasPermission();
+        return result.granted;
+    }
+    /**
+     * REQUEST_INSTALL_PACKAGES 권한 요청 (설정 화면으로 이동)
+     */
+    static async requestPermission() {
+        await ApkInstallerPlugin.requestPermission();
+    }
+    /**
+     * APK 설치
+     * @param apkUri content:// URI (FileProvider URI)
+     */
+    static async install(apkUri) {
+        await ApkInstallerPlugin.install({ uri: apkUri });
+    }
+    /**
+     * 앱 버전 정보 가져오기
+     */
+    static async getVersionInfo() {
+        return await ApkInstallerPlugin.getVersionInfo();
+    }
+}

package/dist/AutoUpdate.d.ts

@@ -0,0 +1,16 @@
+import { SdServiceClient } from "@simplysm/sd-service-client";
+export declare abstract class AutoUpdate {
+    private static _throwAboutReinstall;
+    private static _checkPermissionAsync;
+    private static _installApkAsync;
+    private static _getErrorMessage;
+    private static _freezeApp;
+    static runAsync(opt: {
+        log: (messageHtml: string) => void;
+        serviceClient: SdServiceClient;
+    }): Promise<void>;
+    static runByExternalStorageAsync(opt: {
+        log: (messageHtml: string) => void;
+        dirPath: string;
+    }): Promise<void>;
+}

package/dist/AutoUpdate.js

@@ -0,0 +1,185 @@
+import { FileSystem } from "@simplysm/capacitor-plugin-file-system";
+import { html, NetUtils, Wait } from "@simplysm/sd-core-common";
+import semver from "semver";
+import { ApkInstaller } from "./ApkInstaller";
+import path from "path";
+export class AutoUpdate {
+    static _throwAboutReinstall(code, targetHref) {
+        const downloadHtml = targetHref != null
+            ? html `
+            <style>
+              ._button {
+                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;
+              }
+
+              ._button:active {
+                background: lightgrey;
+              }
+            </style>
+            <a
+              class="_button"
+              href="intent://${targetHref.replace(/^https?:\/\//, "")}#Intent;scheme=http;end"
+            >
+              다운로드
+            </a>
+          `
+            : "";
+        throw new Error(html `
+      APK파일을 다시 다운로드 받아, 설치해야 합니다(${code}). ${downloadHtml}
+    `);
+    }
+    static async _checkPermissionAsync(log, targetHref) {
+        if (!navigator.userAgent.toLowerCase().includes("android")) {
+            throw new Error(`안드로이드만 지원합니다.`);
+        }
+        try {
+            if (!(await ApkInstaller.hasPermissionManifest())) {
+                this._throwAboutReinstall(1, targetHref);
+            }
+        }
+        catch {
+            this._throwAboutReinstall(2, targetHref);
+        }
+        const hasPerm = await ApkInstaller.hasPermission();
+        if (!hasPerm) {
+            log(html `
+        설치권한이 설정되어야합니다.
+        <style>
+          button {
+            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;
+          }
+
+          button:active {
+            background: lightgrey;
+          }
+        </style>
+        <button onclick="location.reload()">재시도</button>
+      `);
+            await ApkInstaller.requestPermission();
+            await Wait.until(async () => {
+                return await ApkInstaller.hasPermission();
+            }, 1000);
+        }
+    }
+    static async _installApkAsync(log, apkFilePath) {
+        log(html `
+      최신버전을 설치한 후 재시작하세요.
+      <style>
+        button {
+          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;
+        }
+
+        button:active {
+          background: lightgrey;
+        }
+      </style>
+      <button onclick="location.reload()">재시도</button>
+    `);
+        const apkFileUri = await FileSystem.getFileUriAsync(apkFilePath);
+        await ApkInstaller.install(apkFileUri);
+        return false;
+    }
+    static _getErrorMessage(err) {
+        return html `
+      업데이트 중 오류 발생:
+      <br />
+      ${err instanceof Error ? err.message : String(err)}
+    `;
+    }
+    static async _freezeApp() {
+        await new Promise(() => { }); // 무한대기
+    }
+    static async runAsync(opt) {
+        try {
+            opt.log(`최신버전 확인 중...`);
+            // 서버의 버전 및 다운로드링크 가져오기
+            const autoUpdateServiceClient = opt.serviceClient.getService("SdAutoUpdateService");
+            const serverVersionInfo = await autoUpdateServiceClient.getLastVersion("android");
+            if (!serverVersionInfo) {
+                throw new Error("서버에서 최신버전 정보를 가져오지 못했습니다.");
+            }
+            opt.log(`권한 확인 중...`);
+            await this._checkPermissionAsync(opt.log, opt.serviceClient.hostUrl + serverVersionInfo.downloadPath);
+            // 최신버전이면 반환
+            if (process.env["SD_VERSION"] === serverVersionInfo.version) {
+                return;
+            }
+            opt.log(`최신버전 파일 다운로드중...`);
+            const buffer = await NetUtils.downloadBufferAsync(opt.serviceClient.hostUrl + serverVersionInfo.downloadPath, (progress) => {
+                const progressText = ((progress.receivedLength * 100) / progress.contentLength).toFixed(2);
+                opt.log(`최신버전 파일 다운로드중...(${progressText}%)`);
+            });
+            const storagePath = await FileSystem.getStoragePathAsync("appCache");
+            const apkFilePath = path.join(storagePath, `latest.apk`);
+            await FileSystem.writeFileAsync(apkFilePath, buffer);
+            await this._installApkAsync(opt.log, apkFilePath);
+            await this._freezeApp();
+        }
+        catch (err) {
+            opt.log(this._getErrorMessage(err));
+            await this._freezeApp();
+        }
+    }
+    static async runByExternalStorageAsync(opt) {
+        try {
+            opt.log(`권한 확인 중...`);
+            await this._checkPermissionAsync(opt.log);
+            opt.log(`최신버전 확인 중...`);
+            // 버전 가져오기
+            const externalPath = await FileSystem.getStoragePathAsync("external");
+            const fileInfos = await FileSystem.readdirAsync(path.join(externalPath, opt.dirPath));
+            const versions = fileInfos
+                .filter((fileInfo) => !fileInfo.isDirectory)
+                .map((fileInfo) => ({
+                fileName: fileInfo.name,
+                version: path.basename(fileInfo.name, path.extname(fileInfo.name)),
+                extName: path.extname(fileInfo.name),
+            }))
+                .filter((item) => {
+                return item.extName === ".apk" && /^[0-9.]*$/.test(item.version);
+            });
+            // 버전파일 저장된것 없으면 반환
+            if (versions.length === 0)
+                return;
+            const latestVersion = semver.maxSatisfying(versions.map((item) => item.version), "*");
+            // 최신버전이면 반환
+            if (process.env["SD_VERSION"] === latestVersion) {
+                return;
+            }
+            const apkFilePath = path.join(externalPath, opt.dirPath, latestVersion + ".apk");
+            await this._installApkAsync(opt.log, apkFilePath);
+            await this._freezeApp();
+        }
+        catch (err) {
+            opt.log(this._getErrorMessage(err));
+            await this._freezeApp();
+        }
+    }
+}

package/dist/IApkInstallerPlugin.d.ts

@@ -0,0 +1,17 @@
+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/dist/IApkInstallerPlugin.js

@@ -0,0 +1 @@
+export {};

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./ApkInstaller";
+export * from "./AutoUpdate";
+export * from "./IApkInstallerPlugin";
+export * from "./web/ApkInstallerWeb";

package/dist/index.js

@@ -0,0 +1,4 @@
+export * from "./ApkInstaller";
+export * from "./AutoUpdate";
+export * from "./IApkInstallerPlugin";
+export * from "./web/ApkInstallerWeb";

package/dist/web/ApkInstallerWeb.d.ts

@@ -0,0 +1,15 @@
+import { WebPlugin } from "@capacitor/core";
+import { IApkInstallerPlugin, IVersionInfo } from "../IApkInstallerPlugin";
+export declare class ApkInstallerWeb extends WebPlugin implements IApkInstallerPlugin {
+    install(_options: {
+        uri: string;
+    }): Promise<void>;
+    hasPermission(): Promise<{
+        granted: boolean;
+    }>;
+    requestPermission(): Promise<void>;
+    hasPermissionManifest(): Promise<{
+        declared: boolean;
+    }>;
+    getVersionInfo(): Promise<IVersionInfo>;
+}

package/dist/web/ApkInstallerWeb.js

@@ -0,0 +1,24 @@
+import { WebPlugin } from "@capacitor/core";
+export class ApkInstallerWeb extends WebPlugin {
+    async install(_options) {
+        alert("[ApkInstaller] 웹 환경에서는 APK 설치를 지원하지 않습니다.");
+        await Promise.resolve();
+    }
+    async hasPermission() {
+        // 웹에서는 권한 체크 스킵
+        return await Promise.resolve({ granted: true });
+    }
+    async requestPermission() {
+        // no-op
+    }
+    async hasPermissionManifest() {
+        // 웹에서는 매니페스트 체크 스킵
+        return await Promise.resolve({ declared: true });
+    }
+    async getVersionInfo() {
+        return await Promise.resolve({
+            versionName: process.env["SD_VERSION"] ?? "0.0.0",
+            versionCode: "0",
+        });
+    }
+}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@simplysm/capacitor-plugin-auto-update",
+  "version": "12.15.69",
+  "description": "심플리즘 패키지 - Capacitor Plugin Auto Update",
+  "author": "김석래",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kslhunter/simplysm.git",
+    "directory": "packages/capacitor-plugin-auto-update"
+  },
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "capacitor": {
+    "android": {
+      "src": "android"
+    }
+  },
+  "dependencies": {
+    "@capacitor/core": "^7.4.4",
+    "@simplysm/capacitor-plugin-file-system": "12.15.69",
+    "@simplysm/sd-core-common": "12.15.69",
+    "@simplysm/sd-service-client": "12.15.69",
+    "@simplysm/sd-service-common": "12.15.69",
+    "semver": "^7.7.3"
+  },
+  "devDependencies": {
+    "@types/semver": "^7.7.1"
+  }
+}

package/src/ApkInstaller.ts

@@ -0,0 +1,54 @@
+import { registerPlugin } from "@capacitor/core";
+import { IApkInstallerPlugin, IVersionInfo } from "./IApkInstallerPlugin";
+
+const ApkInstallerPlugin = registerPlugin<IApkInstallerPlugin>("ApkInstaller", {
+  web: async () => {
+    const { ApkInstallerWeb } = await import("./web/ApkInstallerWeb");
+    return new ApkInstallerWeb();
+  },
+});
+
+/**
+ * APK 설치 플러그인
+ * - Android: APK 설치 인텐트 실행, REQUEST_INSTALL_PACKAGES 권한 관리
+ * - Browser: alert으로 안내 후 정상 반환
+ */
+export abstract class ApkInstaller {
+  /**
+   * Manifest에 REQUEST_INSTALL_PACKAGES 권한이 선언되어 있는지 확인
+   */
+  static async hasPermissionManifest(): Promise<boolean> {
+    const result = await ApkInstallerPlugin.hasPermissionManifest();
+    return result.declared;
+  }
+
+  /**
+   * REQUEST_INSTALL_PACKAGES 권한이 허용되어 있는지 확인
+   */
+  static async hasPermission(): Promise<boolean> {
+    const result = await ApkInstallerPlugin.hasPermission();
+    return result.granted;
+  }
+
+  /**
+   * REQUEST_INSTALL_PACKAGES 권한 요청 (설정 화면으로 이동)
+   */
+  static async requestPermission(): Promise<void> {
+    await ApkInstallerPlugin.requestPermission();
+  }
+
+  /**
+   * APK 설치
+   * @param apkUri content:// URI (FileProvider URI)
+   */
+  static async install(apkUri: string): Promise<void> {
+    await ApkInstallerPlugin.install({ uri: apkUri });
+  }
+
+  /**
+   * 앱 버전 정보 가져오기
+   */
+  static async getVersionInfo(): Promise<IVersionInfo> {
+    return await ApkInstallerPlugin.getVersionInfo();
+  }
+}

package/src/AutoUpdate.ts

@@ -0,0 +1,228 @@
+import { FileSystem } from "@simplysm/capacitor-plugin-file-system";
+import { html, NetUtils, Wait } from "@simplysm/sd-core-common";
+import { SdServiceClient } from "@simplysm/sd-service-client";
+import { ISdAutoUpdateService } from "@simplysm/sd-service-common";
+import semver from "semver";
+import { ApkInstaller } from "./ApkInstaller";
+import path from "path";
+
+export abstract class AutoUpdate {
+  private static _throwAboutReinstall(code: number, targetHref?: string) {
+    const downloadHtml =
+      targetHref != null
+        ? html`
+            <style>
+              ._button {
+                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;
+              }
+
+              ._button:active {
+                background: lightgrey;
+              }
+            </style>
+            <a
+              class="_button"
+              href="intent://${targetHref.replace(/^https?:\/\//, "")}#Intent;scheme=http;end"
+            >
+              다운로드
+            </a>
+          `
+        : "";
+
+    throw new Error(html`
+      APK파일을 다시 다운로드 받아, 설치해야 합니다(${code}). ${downloadHtml}
+    `);
+  }
+
+  private static async _checkPermissionAsync(
+    log: (messageHtml: string) => void,
+    targetHref?: string,
+  ) {
+    if (!navigator.userAgent.toLowerCase().includes("android")) {
+      throw new Error(`안드로이드만 지원합니다.`);
+    }
+
+    try {
+      if (!(await ApkInstaller.hasPermissionManifest())) {
+        this._throwAboutReinstall(1, targetHref);
+      }
+    } catch {
+      this._throwAboutReinstall(2, targetHref);
+    }
+
+    const hasPerm = await ApkInstaller.hasPermission();
+    if (!hasPerm) {
+      log(html`
+        설치권한이 설정되어야합니다.
+        <style>
+          button {
+            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;
+          }
+
+          button:active {
+            background: lightgrey;
+          }
+        </style>
+        <button onclick="location.reload()">재시도</button>
+      `);
+      await ApkInstaller.requestPermission();
+      await Wait.until(async () => {
+        return await ApkInstaller.hasPermission();
+      }, 1000);
+    }
+  }
+
+  private static async _installApkAsync(log: (messageHtml: string) => void, apkFilePath: string) {
+    log(html`
+      최신버전을 설치한 후 재시작하세요.
+      <style>
+        button {
+          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;
+        }
+
+        button:active {
+          background: lightgrey;
+        }
+      </style>
+      <button onclick="location.reload()">재시도</button>
+    `);
+    const apkFileUri = await FileSystem.getFileUriAsync(apkFilePath);
+    await ApkInstaller.install(apkFileUri);
+    return false;
+  }
+
+  private static _getErrorMessage(err: unknown) {
+    return html`
+      업데이트 중 오류 발생:
+      <br />
+      ${err instanceof Error ? err.message : String(err)}
+    `;
+  }
+
+  private static async _freezeApp() {
+    await new Promise(() => {}); // 무한대기
+  }
+
+  static async runAsync(opt: {
+    log: (messageHtml: string) => void;
+    serviceClient: SdServiceClient;
+  }) {
+    try {
+      opt.log(`최신버전 확인 중...`);
+
+      // 서버의 버전 및 다운로드링크 가져오기
+      const autoUpdateServiceClient =
+        opt.serviceClient.getService<ISdAutoUpdateService>("SdAutoUpdateService");
+
+      const serverVersionInfo = await autoUpdateServiceClient.getLastVersion("android");
+      if (!serverVersionInfo) {
+        throw new Error("서버에서 최신버전 정보를 가져오지 못했습니다.");
+      }
+
+      opt.log(`권한 확인 중...`);
+      await this._checkPermissionAsync(
+        opt.log,
+        opt.serviceClient.hostUrl + serverVersionInfo.downloadPath,
+      );
+
+      // 최신버전이면 반환
+      if (process.env["SD_VERSION"] === serverVersionInfo.version) {
+        return;
+      }
+
+      opt.log(`최신버전 파일 다운로드중...`);
+      const buffer = await NetUtils.downloadBufferAsync(
+        opt.serviceClient.hostUrl + serverVersionInfo.downloadPath,
+        (progress) => {
+          const progressText = ((progress.receivedLength * 100) / progress.contentLength).toFixed(
+            2,
+          );
+          opt.log(`최신버전 파일 다운로드중...(${progressText}%)`);
+        },
+      );
+      const storagePath = await FileSystem.getStoragePathAsync("appCache");
+      const apkFilePath = path.join(storagePath, `latest.apk`);
+      await FileSystem.writeFileAsync(apkFilePath, buffer);
+
+      await this._installApkAsync(opt.log, apkFilePath);
+      await this._freezeApp();
+    } catch (err) {
+      opt.log(this._getErrorMessage(err));
+      await this._freezeApp();
+    }
+  }
+
+  static async runByExternalStorageAsync(opt: {
+    log: (messageHtml: string) => void;
+    dirPath: string;
+  }) {
+    try {
+      opt.log(`권한 확인 중...`);
+      await this._checkPermissionAsync(opt.log);
+
+      opt.log(`최신버전 확인 중...`);
+
+      // 버전 가져오기
+      const externalPath = await FileSystem.getStoragePathAsync("external");
+      const fileInfos = await FileSystem.readdirAsync(path.join(externalPath, opt.dirPath));
+
+      const versions = fileInfos
+        .filter((fileInfo) => !fileInfo.isDirectory)
+        .map((fileInfo) => ({
+          fileName: fileInfo.name,
+          version: path.basename(fileInfo.name, path.extname(fileInfo.name)),
+          extName: path.extname(fileInfo.name),
+        }))
+        .filter((item) => {
+          return item.extName === ".apk" && /^[0-9.]*$/.test(item.version);
+        });
+
+      // 버전파일 저장된것 없으면 반환
+      if (versions.length === 0) return;
+
+      const latestVersion = semver.maxSatisfying(
+        versions.map((item) => item.version),
+        "*",
+      )!;
+
+      // 최신버전이면 반환
+      if (process.env["SD_VERSION"] === latestVersion) {
+        return;
+      }
+
+      const apkFilePath = path.join(externalPath, opt.dirPath, latestVersion + ".apk");
+      await this._installApkAsync(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,4 @@
+export * from "./ApkInstaller";
+export * from "./AutoUpdate";
+export * from "./IApkInstallerPlugin";
+export * from "./web/ApkInstallerWeb";

package/src/web/ApkInstallerWeb.ts

@@ -0,0 +1,30 @@
+import { WebPlugin } from "@capacitor/core";
+import { IApkInstallerPlugin, IVersionInfo } from "../IApkInstallerPlugin";
+
+export class ApkInstallerWeb extends WebPlugin implements IApkInstallerPlugin {
+  async install(_options: { uri: string }): Promise<void> {
+    alert("[ApkInstaller] 웹 환경에서는 APK 설치를 지원하지 않습니다.");
+    await Promise.resolve();
+  }
+
+  async hasPermission(): Promise<{ granted: boolean }> {
+    // 웹에서는 권한 체크 스킵
+    return await Promise.resolve({ granted: true });
+  }
+
+  async requestPermission(): Promise<void> {
+    // no-op
+  }
+
+  async hasPermissionManifest(): Promise<{ declared: boolean }> {
+    // 웹에서는 매니페스트 체크 스킵
+    return await Promise.resolve({ declared: true });
+  }
+
+  async getVersionInfo(): Promise<IVersionInfo> {
+    return await Promise.resolve({
+      versionName: process.env["SD_VERSION"] ?? "0.0.0",
+      versionCode: "0",
+    });
+  }
+}

package/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "lib": ["ES2021", "DOM"],
+    "outDir": "./dist"
+  },
+  "exclude": ["dist", "node_modules"]
+}