@simplysm/capacitor-plugin-auto-update 13.0.100 → 14.0.4

package/README.md

@@ -1,6 +1,6 @@
 # @simplysm/capacitor-plugin-auto-update
 
-Simplysm Package - Capacitor Auto Update Plugin. Provides APK installation and OTA auto-update functionality for Android Capacitor apps.
+Capacitor auto-update plugin for Android APK installation and OTA updates.
 
 ## Installation
 
@@ -10,85 +10,105 @@ npm install @simplysm/capacitor-plugin-auto-update
 
 ## API Overview
 
-### APK Installer
+### APK Installation
 
 | API | Type | Description |
 |-----|------|-------------|
-| `ApkInstaller` | class | APK installation plugin (static methods) |
-| `ApkInstallerPlugin` | interface | Low-level Capacitor plugin interface for APK installation |
-| `VersionInfo` | interface | App version information |
+| `VersionInfo` | Interface | App version information |
+| `ApkInstallerPlugin` | Interface | Native plugin interface for APK installation |
+| `ApkInstaller` | Class | Static API for APK installation, permission management, and version info |
 
 ### Auto Update
 
 | API | Type | Description |
 |-----|------|-------------|
-| `AutoUpdate` | class | OTA auto-update manager (static methods) |
+| `AutoUpdate` | Class | Static API for downloading and installing APK updates from a server or external storage |
 
----
+## Interfaces
 
-### `VersionInfo`
+### VersionInfo
+
+Holds application version information.
 
 | Field | Type | Description |
 |-------|------|-------------|
-| `versionName` | `string` | App version name (e.g., `"1.0.0"`) |
-| `versionCode` | `string` | App version code |
+| `versionName` | `string` | Human-readable version name (e.g. `"1.2.3"`) |
+| `versionCode` | `string` | Numeric version code used by the Android system |
+
+### ApkInstallerPlugin
 
-### `ApkInstallerPlugin`
+Native plugin interface for APK installation.
 
 | Method | Signature | Description |
 |--------|-----------|-------------|
-| `install` | `(options: { uri: string }) => Promise<void>` | Install APK from URI |
-| `checkPermissions` | `() => Promise<{ granted: boolean; manifest: boolean }>` | Check install permissions |
-| `requestPermissions` | `() => Promise<void>` | Request install permissions |
-| `getVersionInfo` | `() => Promise<VersionInfo>` | Get app version info |
+| `install` | `(options: { uri: string }) => Promise<void>` | Install APK from the given content URI |
+| `checkPermissions` | `() => Promise<{ granted: boolean; manifest: boolean }>` | Check whether install permissions are granted |
+| `requestPermissions` | `() => Promise<void>` | Request the `REQUEST_INSTALL_PACKAGES` permission |
+| `getVersionInfo` | `() => Promise<VersionInfo>` | Retrieve current app version info |
+
+## Classes
 
-### `ApkInstaller`
+### ApkInstaller
 
-Abstract class with static methods. Android executes APK install intent; browser shows alert and returns normally.
+APK installation plugin. On Android it runs the APK install intent and manages the `REQUEST_INSTALL_PACKAGES` permission. On the browser it shows a notification and returns normally.
+
+All methods are static.
 
 | Method | Signature | Description |
 |--------|-----------|-------------|
-| `checkPermissions` | `() => Promise<{ granted: boolean; manifest: boolean }>` | Check install permission (granted + manifest declared) |
-| `requestPermissions` | `() => Promise<void>` | Request REQUEST_INSTALL_PACKAGES permission (navigates to settings) |
-| `install` | `(apkUri: string) => Promise<void>` | Install APK from a `content://` URI (FileProvider URI) |
-| `getVersionInfo` | `() => Promise<VersionInfo>` | Get app version info |
+| `checkPermissions` | `static async checkPermissions(): Promise<{ granted: boolean; manifest: boolean }>` | Check whether install permissions are currently granted |
+| `requestPermissions` | `static async requestPermissions(): Promise<void>` | Request the `REQUEST_INSTALL_PACKAGES` permission from the user |
+| `install` | `static async install(apkUri: string): Promise<void>` | Install an APK from a `content://` URI |
+| `getVersionInfo` | `static async getVersionInfo(): Promise<VersionInfo>` | Get the current app version name and version code |
+
+### AutoUpdate
 
-### `AutoUpdate`
+Handles the full update flow: download an APK and install it.
 
-Abstract class with static methods for OTA update management.
+All methods are static.
 
 | Method | Signature | Description |
 |--------|-----------|-------------|
-| `run` | `(opt: { log: (messageHtml: string) => void; serviceClient: ServiceClient }) => Promise<void>` | Run auto-update via server (checks version, downloads APK, installs) |
-| `runByExternalStorage` | `(opt: { log: (messageHtml: string) => void; dirPath: string }) => Promise<void>` | Run auto-update from external storage directory |
+| `run` | `static async run(opt: { log: (messageHtml: string) => void; serviceClient: ServiceClient }): Promise<void>` | Download the latest APK from a server via `ServiceClient` and install it. Progress is reported through the `log` callback as HTML strings. |
+| `runByExternalStorage` | `static async runByExternalStorage(opt: { log: (messageHtml: string) => void; dirPath: string }): Promise<void>` | Find the latest APK file from an external storage directory and install it. Progress is reported through the `log` callback. |
 
 ## Usage Examples
 
-### Check and install APK
+### Check permissions and install an APK
 
-```typescript
+```ts
 import { ApkInstaller } from "@simplysm/capacitor-plugin-auto-update";
 
-// Check permissions
 const perms = await ApkInstaller.checkPermissions();
 if (!perms.granted) {
   await ApkInstaller.requestPermissions();
 }
 
-// Install APK
-await ApkInstaller.install("content://com.example.fileprovider/apk/update.apk");
-
-// Get version info
-const version = await ApkInstaller.getVersionInfo();
+await ApkInstaller.install("content://com.example.provider/apk/update.apk");
 ```
 
-### Run OTA auto-update
+### Auto-update from a server
 
-```typescript
+```ts
 import { AutoUpdate } from "@simplysm/capacitor-plugin-auto-update";
 
 await AutoUpdate.run({
-  log: (messageHtml) => { /* display status */ },
+  log: (messageHtml) => {
+    document.getElementById("status")!.innerHTML = messageHtml;
+  },
   serviceClient: myServiceClient,
 });
 ```
+
+### Auto-update from external storage
+
+```ts
+import { AutoUpdate } from "@simplysm/capacitor-plugin-auto-update";
+
+await AutoUpdate.runByExternalStorage({
+  log: (messageHtml) => {
+    document.getElementById("status")!.innerHTML = messageHtml;
+  },
+  dirPath: "/storage/emulated/0/Download/updates",
+});
+```

package/android/build.gradle

@@ -1,4 +1,5 @@
 apply plugin: 'com.android.library'
+apply plugin: 'kotlin-android'
 
 android {
     namespace "kr.co.simplysm.capacitor.apkinstaller"

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

@@ -0,0 +1,114 @@
+package kr.co.simplysm.capacitor.apkinstaller
+
+import android.content.Intent
+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")
+class ApkInstallerPlugin : Plugin() {
+
+    companion object {
+        private const val TAG = "ApkInstallerPlugin"
+    }
+
+    @PluginMethod
+    fun install(call: PluginCall) {
+        val uriStr = call.getString("uri")
+        if (uriStr == null) {
+            call.reject("uri is required")
+            return
+        }
+
+        try {
+            val apkUri = Uri.parse(uriStr)
+
+            val intent = Intent(Intent.ACTION_VIEW)
+            intent.setDataAndType(apkUri, "application/vnd.android.package-archive")
+            intent.flags = Intent.FLAG_ACTIVITY_NEW_TASK or Intent.FLAG_GRANT_READ_URI_PERMISSION
+
+            context.startActivity(intent)
+            call.resolve()
+        } catch (e: Exception) {
+            Log.e(TAG, "install failed", e)
+            call.reject("Install failed: " + e.message)
+        }
+    }
+
+    @PluginMethod
+    fun checkPermissions(call: PluginCall) {
+        // Check granted
+        val granted = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+            context.packageManager.canRequestPackageInstalls()
+        } else {
+            true
+        }
+
+        // Check manifest
+        var manifest = false
+        try {
+            val targetPermission = "android.permission.REQUEST_INSTALL_PACKAGES"
+            val requestedPermissions = context.packageManager
+                .getPackageInfo(context.packageName, PackageManager.GET_PERMISSIONS)
+                .requestedPermissions
+            if (requestedPermissions != null) {
+                for (perm in requestedPermissions) {
+                    if (targetPermission == perm) {
+                        manifest = true
+                        break
+                    }
+                }
+            }
+        } catch (e: Exception) {
+            Log.e(TAG, "checkPermissions manifest check failed", e)
+        }
+
+        val ret = JSObject()
+        ret.put("granted", granted)
+        ret.put("manifest", manifest)
+        call.resolve(ret)
+    }
+
+    @PluginMethod
+    fun requestPermissions(call: PluginCall) {
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+            val intent = Intent(Settings.ACTION_MANAGE_UNKNOWN_APP_SOURCES)
+            intent.data = Uri.parse("package:" + context.packageName)
+            intent.flags = Intent.FLAG_ACTIVITY_NEW_TASK
+            context.startActivity(intent)
+        }
+        call.resolve()
+    }
+
+    @PluginMethod
+    fun getVersionInfo(call: PluginCall) {
+        try {
+            val pm = context.packageManager
+            val info = pm.getPackageInfo(context.packageName, 0)
+
+            val versionName = info.versionName
+            val versionCode = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
+                info.longVersionCode
+            } else {
+                @Suppress("DEPRECATION")
+                info.versionCode.toLong()
+            }
+
+            val ret = JSObject()
+            ret.put("versionName", versionName)
+            ret.put("versionCode", versionCode.toString())
+            call.resolve(ret)
+        } catch (e: Exception) {
+            Log.e(TAG, "getVersionInfo failed", e)
+            call.reject("getVersionInfo failed: " + e.message)
+        }
+    }
+}

package/dist/ApkInstaller.d.ts

@@ -1,28 +1,28 @@
 import type { VersionInfo } from "./ApkInstallerPlugin";
 /**
- * APK installation plugin
- * - Android: Executes APK install intent, manages REQUEST_INSTALL_PACKAGES permission
- * - Browser: Shows alert message and returns normally
+ * APK 설치 플러그인
+ * - Android: APK 설치 인텐트를 실행하고, REQUEST_INSTALL_PACKAGES 권한을 관리
+ * - Browser: 알림 메시지를 표시하고 정상 반환
  */
 export declare abstract class ApkInstaller {
     /**
-     * Check permissions (install permission granted + manifest declared)
+     * 권한 확인 (설치 권한 승인 여부 + manifest 선언 여부)
      */
     static checkPermissions(): Promise<{
         granted: boolean;
         manifest: boolean;
     }>;
     /**
-     * Request REQUEST_INSTALL_PACKAGES permission (navigates to settings)
+     * REQUEST_INSTALL_PACKAGES 권한 요청 (설정 화면으로 이동)
      */
     static requestPermissions(): Promise<void>;
     /**
-     * Install APK
+     * APK 설치
      * @param apkUri content:// URI (FileProvider URI)
      */
     static install(apkUri: string): Promise<void>;
     /**
-     * Get app version info
+     * 앱 버전 정보 조회
      */
     static getVersionInfo(): Promise<VersionInfo>;
 }

package/dist/ApkInstaller.js

@@ -1,38 +1,40 @@
 import { registerPlugin } from "@capacitor/core";
 const apkInstallerPlugin = registerPlugin("ApkInstaller", {
-  web: async () => {
-    const { ApkInstallerWeb } = await import("./web/ApkInstallerWeb");
-    return new ApkInstallerWeb();
-  }
+    web: async () => {
+        const { ApkInstallerWeb } = await import("./web/ApkInstallerWeb.js");
+        return new ApkInstallerWeb();
+    },
 });
-class ApkInstaller {
-  /**
-   * Check permissions (install permission granted + manifest declared)
-   */
-  static async checkPermissions() {
-    return apkInstallerPlugin.checkPermissions();
-  }
-  /**
-   * Request REQUEST_INSTALL_PACKAGES permission (navigates to settings)
-   */
-  static async requestPermissions() {
-    await apkInstallerPlugin.requestPermissions();
-  }
-  /**
-   * 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();
-  }
+/**
+ * APK 설치 플러그인
+ * - Android: APK 설치 인텐트를 실행하고, REQUEST_INSTALL_PACKAGES 권한을 관리
+ * - Browser: 알림 메시지를 표시하고 정상 반환
+ */
+export class ApkInstaller {
+    /**
+     * 권한 확인 (설치 권한 승인 여부 + manifest 선언 여부)
+     */
+    static async checkPermissions() {
+        return apkInstallerPlugin.checkPermissions();
+    }
+    /**
+     * REQUEST_INSTALL_PACKAGES 권한 요청 (설정 화면으로 이동)
+     */
+    static async requestPermissions() {
+        await apkInstallerPlugin.requestPermissions();
+    }
+    /**
+     * APK 설치
+     * @param apkUri content:// URI (FileProvider URI)
+     */
+    static async install(apkUri) {
+        await apkInstallerPlugin.install({ uri: apkUri });
+    }
+    /**
+     * 앱 버전 정보 조회
+     */
+    static async getVersionInfo() {
+        return apkInstallerPlugin.getVersionInfo();
+    }
 }
-export {
-  ApkInstaller
-};
-//# sourceMappingURL=ApkInstaller.js.map
+//# sourceMappingURL=ApkInstaller.js.map

package/dist/ApkInstaller.js.map

@@ -1,6 +1 @@
-{
-  "version": 3,
-  "sources": ["../src/ApkInstaller.ts"],
-  "mappings": "AAAA,SAAS,sBAAsB;AAG/B,MAAM,qBAAqB,eAAmC,gBAAgB;AAAA,EAC5E,KAAK,YAAY;AACf,UAAM,EAAE,gBAAgB,IAAI,MAAM,OAAO,uBAAuB;AAChE,WAAO,IAAI,gBAAgB;AAAA,EAC7B;AACF,CAAC;AAOM,MAAe,aAAa;AAAA;AAAA;AAAA;AAAA,EAIjC,aAAa,mBAAqE;AAChF,WAAO,mBAAmB,iBAAiB;AAAA,EAC7C;AAAA;AAAA;AAAA;AAAA,EAKA,aAAa,qBAAoC;AAC/C,UAAM,mBAAmB,mBAAmB;AAAA,EAC9C;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,aAAa,QAAQ,QAA+B;AAClD,UAAM,mBAAmB,QAAQ,EAAE,KAAK,OAAO,CAAC;AAAA,EAClD;AAAA;AAAA;AAAA;AAAA,EAKA,aAAa,iBAAuC;AAClD,WAAO,mBAAmB,eAAe;AAAA,EAC3C;AACF;",
-  "names": []
-}
+{"version":3,"file":"ApkInstaller.js","sourceRoot":"","sources":["..\\src\\ApkInstaller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGjD,MAAM,kBAAkB,GAAG,cAAc,CAAqB,cAAc,EAAE;IAC5E,GAAG,EAAE,KAAK,IAAI,EAAE;QACd,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;QAClE,OAAO,IAAI,eAAe,EAAE,CAAC;IAC/B,CAAC;CACF,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,OAAgB,YAAY;IAChC;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,gBAAgB;QAC3B,OAAO,kBAAkB,CAAC,gBAAgB,EAAE,CAAC;IAC/C,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,kBAAkB;QAC7B,MAAM,kBAAkB,CAAC,kBAAkB,EAAE,CAAC;IAChD,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAc;QACjC,MAAM,kBAAkB,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;IACpD,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,cAAc;QACzB,OAAO,kBAAkB,CAAC,cAAc,EAAE,CAAC;IAC7C,CAAC;CACF"}

package/dist/ApkInstallerPlugin.js

@@ -1 +1,2 @@
-//# sourceMappingURL=ApkInstallerPlugin.js.map
+export {};
+//# sourceMappingURL=ApkInstallerPlugin.js.map

package/dist/ApkInstallerPlugin.js.map

@@ -1,6 +1 @@
-{
-  "version": 3,
-  "sources": [],
-  "mappings": "",
-  "names": []
-}
+{"version":3,"file":"ApkInstallerPlugin.js","sourceRoot":"","sources":["..\\src\\ApkInstallerPlugin.ts"],"names":[],"mappings":""}

package/dist/AutoUpdate.js

@@ -3,8 +3,8 @@ import { html, wait, path } from "@simplysm/core-common";
 import { fetchUrlBytes } from "@simplysm/core-browser";
 import semver from "semver";
 import { ApkInstaller } from "./ApkInstaller.js";
-class AutoUpdate {
-  static _BUTTON_CSS = `
+export class AutoUpdate {
+    static _BUTTON_CSS = `
     all: unset;
     color: blue;
     width: 100%;
@@ -16,11 +16,12 @@ class AutoUpdate {
     left: 0;
     border-top: 1px solid lightgrey;
   `;
-  static _BUTTON_ACTIVE_CSS = `
+    static _BUTTON_ACTIVE_CSS = `
     background: lightgrey;
   `;
-  static _throwAboutReinstall(code, targetHref) {
-    const downloadHtml = targetHref != null ? html`
+    static _throwAboutReinstall(code, targetHref) {
+        const downloadHtml = targetHref != null
+            ? html `
             <style>
               ._button { ${this._BUTTON_CSS} }
               ._button:active { ${this._BUTTON_ACTIVE_CSS} }
@@ -29,157 +30,162 @@ class AutoUpdate {
               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}
+          `
+            : "";
+        throw new Error(html `
+      APK 파일을 다시 다운로드하여 설치해야 합니다(${code}). ${downloadHtml}
     `);
-  }
-  static async _checkPermission(log, targetHref) {
-    if (!navigator.userAgent.toLowerCase().includes("android")) {
-      throw new Error("Only Android is supported.");
     }
-    let granted;
-    try {
-      const result = await ApkInstaller.checkPermissions();
-      if (!result.manifest) {
-        this._throwAboutReinstall(1, targetHref);
-      }
-      granted = result.granted;
-    } catch (err) {
-      console.error("[AutoUpdate] checkPermissions manifest check failed:", err);
-      this._throwAboutReinstall(2, targetHref);
-      return;
-    }
-    if (!granted) {
-      log(html`
-        Installation permission must be enabled.
+    static async _checkPermission(log, targetHref) {
+        if (!navigator.userAgent.toLowerCase().includes("android")) {
+            throw new Error("Android만 지원됩니다.");
+        }
+        let granted;
+        try {
+            const result = await ApkInstaller.checkPermissions();
+            if (!result.manifest) {
+                this._throwAboutReinstall(1, targetHref);
+            }
+            granted = result.granted;
+        }
+        catch (err) {
+            // eslint-disable-next-line no-console
+            console.error("[AutoUpdate] checkPermissions manifest 확인 실패:", err);
+            this._throwAboutReinstall(2, targetHref);
+            return; // 도달 불가 — _throwAboutReinstall은 항상 throw함
+        }
+        if (!granted) {
+            log(html `
+        설치 권한을 활성화해야 합니다.
         <style>
           button { ${this._BUTTON_CSS} }
           button:active { ${this._BUTTON_ACTIVE_CSS} }
         </style>
-        <button onclick="location.reload()">Retry</button>
+        <button onclick="location.reload()">재시도</button>
       `);
-      await ApkInstaller.requestPermissions();
-      await wait.until(
-        async () => {
-          const result = await ApkInstaller.checkPermissions();
-          return result.granted;
-        },
-        1e3,
-        300
-      );
+            await ApkInstaller.requestPermissions();
+            // 최대 5분(300초) 대기 - 사용자가 설정에서 권한을 부여할 시간
+            await wait.until(async () => {
+                const result = await ApkInstaller.checkPermissions();
+                return result.granted;
+            }, 1000, 300);
+        }
     }
-  }
-  static async _installApk(log, apkFilePath) {
-    log(html`
-      Please install the latest version and restart.
+    static async _installApk(log, apkFilePath) {
+        log(html `
+      최신 버전을 설치하고 재시작해 주세요.
       <style>
         button { ${this._BUTTON_CSS} }
         button:active { ${this._BUTTON_ACTIVE_CSS} }
       </style>
-      <button onclick="location.reload()">Retry</button>
+      <button onclick="location.reload()">재시도</button>
     `);
-    const apkFileUri = await FileSystem.getUri(apkFilePath);
-    await ApkInstaller.install(apkFileUri);
-  }
-  static _getErrorMessage(err) {
-    return html`
-      Error occurred during update:
+        const apkFileUri = await FileSystem.getUri(apkFilePath);
+        await ApkInstaller.install(apkFileUri);
+    }
+    static _getErrorMessage(err) {
+        return html `
+      업데이트 중 오류가 발생했습니다:
       <br />
       ${err instanceof Error ? err.message : String(err)}
     `;
-  }
-  static async _freezeApp() {
-    await new Promise(() => {
-    });
-  }
-  static async run(opt) {
-    try {
-      opt.log(`Checking latest version...`);
-      const autoUpdateServiceClient = opt.serviceClient.getService("AutoUpdateService");
-      const serverVersionInfo = await autoUpdateServiceClient.getLastVersion("android");
-      if (!serverVersionInfo) {
-        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
-      );
-      const currentVersionInfo = await ApkInstaller.getVersionInfo();
-      if (semver.valid(currentVersionInfo.versionName) === null || semver.valid(serverVersionInfo.version) === null) {
-        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}%)`);
-          }
+    }
+    static async _freezeApp() {
+        await new Promise(() => { }); // 무한 대기
+    }
+    static async run(opt) {
+        try {
+            opt.log(`최신 버전 확인 중...`);
+            // 서버에서 버전 및 다운로드 링크 조회
+            const autoUpdateServiceClient = opt.serviceClient.getService("AutoUpdateService");
+            const serverVersionInfo = await autoUpdateServiceClient.getLastVersion("android");
+            if (!serverVersionInfo) {
+                // eslint-disable-next-line no-console
+                console.log("서버에서 최신 버전 정보를 가져오지 못했습니다.");
+                return;
+            }
+            opt.log(`권한 확인 중...`);
+            await this._checkPermission(opt.log, opt.serviceClient.hostUrl + serverVersionInfo.downloadPath);
+            // 현재 앱 버전 조회
+            const currentVersionInfo = await ApkInstaller.getVersionInfo();
+            // 이미 최신이거나 서버 버전이 낮으면 반환
+            if (semver.valid(currentVersionInfo.versionName) === null ||
+                semver.valid(serverVersionInfo.version) === null) {
+                // eslint-disable-next-line no-console
+                console.log("유효하지 않은 semver 버전이므로 업데이트 확인을 건너뜁니다");
+                return;
+            }
+            if (!semver.gt(serverVersionInfo.version, currentVersionInfo.versionName)) {
+                return;
+            }
+            opt.log(`최신 버전 파일 다운로드 중...`);
+            const buffer = await fetchUrlBytes(opt.serviceClient.hostUrl + serverVersionInfo.downloadPath, {
+                onProgress: (progress) => {
+                    const progressText = ((progress.receivedLength * 100) / progress.contentLength).toFixed(2);
+                    opt.log(`최신 버전 파일 다운로드 중...(${progressText}%)`);
+                },
+            });
+            const storagePath = await FileSystem.getStoragePath("appCache");
+            const apkFilePath = path.join(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();
         }
-      );
-      const storagePath = await FileSystem.getStoragePath("appCache");
-      const apkFilePath = path.join(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) {
-    try {
-      opt.log(`Checking permission...`);
-      await this._checkPermission(opt.log);
-      opt.log(`Checking latest version...`);
-      const externalPath = await FileSystem.getStoragePath("external");
-      const fileInfos = await FileSystem.readdir(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 (latestVersion == null) {
-        console.log("No valid semver version files found.");
-        return;
-      }
-      const currentVersionInfo = await ApkInstaller.getVersionInfo();
-      if (semver.valid(currentVersionInfo.versionName) === null || semver.valid(latestVersion) === null) {
-        console.log("Invalid semver version, skipping update check");
-        return;
-      }
-      if (!semver.gt(latestVersion, currentVersionInfo.versionName)) {
-        return;
-      }
-      const apkFilePath = path.join(externalPath, opt.dirPath, latestVersion + ".apk");
-      await this._installApk(opt.log, apkFilePath);
-      await this._freezeApp();
-    } catch (err) {
-      opt.log(this._getErrorMessage(err));
-      await this._freezeApp();
+    static async runByExternalStorage(opt) {
+        try {
+            opt.log(`권한 확인 중...`);
+            await this._checkPermission(opt.log);
+            opt.log(`최신 버전 확인 중...`);
+            // 버전 목록 조회
+            const externalPath = await FileSystem.getStoragePath("external");
+            const fileInfos = await FileSystem.readdir(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), "*");
+            // 유효한 semver 버전이 없으면 반환
+            if (latestVersion == null) {
+                // eslint-disable-next-line no-console
+                console.log("유효한 semver 버전 파일을 찾을 수 없습니다.");
+                return;
+            }
+            // 현재 앱 버전 조회
+            const currentVersionInfo = await ApkInstaller.getVersionInfo();
+            // 이미 최신이거나 외부 저장소 버전이 낮으면 반환
+            if (semver.valid(currentVersionInfo.versionName) === null ||
+                semver.valid(latestVersion) === null) {
+                // eslint-disable-next-line no-console
+                console.log("유효하지 않은 semver 버전이므로 업데이트 확인을 건너뜁니다");
+                return;
+            }
+            if (!semver.gt(latestVersion, currentVersionInfo.versionName)) {
+                return;
+            }
+            const apkFilePath = path.join(externalPath, opt.dirPath, latestVersion + ".apk");
+            await this._installApk(opt.log, apkFilePath);
+            await this._freezeApp();
+        }
+        catch (err) {
+            opt.log(this._getErrorMessage(err));
+            await this._freezeApp();
+        }
     }
-  }
 }
-export {
-  AutoUpdate
-};
-//# sourceMappingURL=AutoUpdate.js.map
+//# sourceMappingURL=AutoUpdate.js.map

package/dist/AutoUpdate.js.map

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

package/dist/index.js

@@ -1,4 +1,6 @@
+// APK 설치
 export * from "./ApkInstaller.js";
 export * from "./ApkInstallerPlugin.js";
+// 자동 업데이트
 export * from "./AutoUpdate.js";
-//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1,6 +1 @@
-{
-  "version": 3,
-  "sources": ["../src/index.ts"],
-  "mappings": "AACA,cAAc;AACd,cAAc;AAGd,cAAc;",
-  "names": []
-}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["..\\src\\index.ts"],"names":[],"mappings":"AAAA,SAAS;AACT,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AAErC,UAAU;AACV,cAAc,cAAc,CAAC"}

package/dist/web/ApkInstallerWeb.js

@@ -1,22 +1,21 @@
 import { WebPlugin } from "@capacitor/core";
-class ApkInstallerWeb extends WebPlugin {
-  install(_options) {
-    alert("[ApkInstaller] APK installation is not supported in web environment.");
-    return Promise.resolve();
-  }
-  checkPermissions() {
-    return Promise.resolve({ granted: true, manifest: true });
-  }
-  async requestPermissions() {
-  }
-  getVersionInfo() {
-    return Promise.resolve({
-      versionName: import.meta.env.__VER__ ?? "0.0.0",
-      versionCode: "0"
-    });
-  }
+export class ApkInstallerWeb extends WebPlugin {
+    install(_options) {
+        alert("[ApkInstaller] 웹 환경에서는 APK 설치를 지원하지 않습니다.");
+        return Promise.resolve();
+    }
+    checkPermissions() {
+        // 웹에서는 권한 확인 생략
+        return Promise.resolve({ granted: true, manifest: true });
+    }
+    async requestPermissions() {
+        // 웹에서는 동작 없음
+    }
+    getVersionInfo() {
+        return Promise.resolve({
+            versionName: import.meta.env.__VER__ ?? "0.0.0",
+            versionCode: "0",
+        });
+    }
 }
-export {
-  ApkInstallerWeb
-};
-//# sourceMappingURL=ApkInstallerWeb.js.map
+//# sourceMappingURL=ApkInstallerWeb.js.map

package/dist/web/ApkInstallerWeb.js.map

@@ -1,6 +1 @@
-{
-  "version": 3,
-  "sources": ["../../src/web/ApkInstallerWeb.ts"],
-  "mappings": "AAAA,SAAS,iBAAiB;AAGnB,MAAM,wBAAwB,UAAwC;AAAA,EAC3E,QAAQ,UAA0C;AAChD,UAAM,sEAAsE;AAC5E,WAAO,QAAQ,QAAQ;AAAA,EACzB;AAAA,EAEA,mBAAqE;AAEnE,WAAO,QAAQ,QAAQ,EAAE,SAAS,MAAM,UAAU,KAAK,CAAC;AAAA,EAC1D;AAAA,EAEA,MAAM,qBAAoC;AAAA,EAE1C;AAAA,EAEA,iBAAuC;AACrC,WAAO,QAAQ,QAAQ;AAAA,MACrB,aACE,YAAY,IAAI,WAAW;AAAA,MAC7B,aAAa;AAAA,IACf,CAAC;AAAA,EACH;AACF;",
-  "names": []
-}
+{"version":3,"file":"ApkInstallerWeb.js","sourceRoot":"","sources":["..\\..\\src\\web\\ApkInstallerWeb.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,MAAM,OAAO,eAAgB,SAAQ,SAAS;IAC5C,OAAO,CAAC,QAAyB;QAC/B,KAAK,CAAC,2CAA2C,CAAC,CAAC;QACnD,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED,gBAAgB;QACd,gBAAgB;QAChB,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,kBAAkB;QACtB,aAAa;IACf,CAAC;IAED,cAAc;QACZ,OAAO,OAAO,CAAC,OAAO,CAAC;YACrB,WAAW,EACT,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,OAAO;YACpC,WAAW,EAAE,GAAG;SACjB,CAAC,CAAC;IACL,CAAC;CACF"}

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@simplysm/capacitor-plugin-auto-update",
-  "version": "13.0.100",
-  "description": "Simplysm Package - Capacitor Auto Update Plugin",
-  "author": "simplysm",
-  "license": "MIT",
+  "version": "14.0.4",
+  "description": "심플리즘 패키지 - Capacitor 자동 업데이트 플러그인",
+  "author": "심플리즘",
+  "license": "Apache-2.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/kslhunter/simplysm.git",
@@ -19,18 +19,18 @@
   ],
   "dependencies": {
     "semver": "^7.7.4",
-    "@simplysm/capacitor-plugin-file-system": "13.0.100",
-    "@simplysm/service-client": "13.0.100",
-    "@simplysm/core-browser": "13.0.100",
-    "@simplysm/core-common": "13.0.100",
-    "@simplysm/service-common": "13.0.100"
+    "@simplysm/capacitor-plugin-file-system": "14.0.4",
+    "@simplysm/core-browser": "14.0.4",
+    "@simplysm/service-client": "14.0.4",
+    "@simplysm/core-common": "14.0.4",
+    "@simplysm/service-common": "14.0.4"
   },
   "devDependencies": {
-    "@capacitor/core": "^7.6.0",
+    "@capacitor/core": "^7.6.1",
     "@types/semver": "^7.7.1"
   },
   "peerDependencies": {
-    "@capacitor/core": "^7.4.4"
+    "@capacitor/core": "^7"
   },
   "capacitor": {
     "android": {

package/src/ApkInstaller.ts

@@ -9,27 +9,27 @@ const apkInstallerPlugin = registerPlugin<ApkInstallerPlugin>("ApkInstaller", {
 });
 
 /**
- * APK installation plugin
- * - Android: Executes APK install intent, manages REQUEST_INSTALL_PACKAGES permission
- * - Browser: Shows alert message and returns normally
+ * APK 설치 플러그인
+ * - Android: APK 설치 인텐트를 실행하고, REQUEST_INSTALL_PACKAGES 권한을 관리
+ * - Browser: 알림 메시지를 표시하고 정상 반환
  */
 export abstract class ApkInstaller {
   /**
-   * Check permissions (install permission granted + manifest declared)
+   * 권한 확인 (설치 권한 승인 여부 + manifest 선언 여부)
    */
   static async checkPermissions(): Promise<{ granted: boolean; manifest: boolean }> {
     return apkInstallerPlugin.checkPermissions();
   }
 
   /**
-   * Request REQUEST_INSTALL_PACKAGES permission (navigates to settings)
+   * REQUEST_INSTALL_PACKAGES 권한 요청 (설정 화면으로 이동)
    */
   static async requestPermissions(): Promise<void> {
     await apkInstallerPlugin.requestPermissions();
   }
 
   /**
-   * Install APK
+   * APK 설치
    * @param apkUri content:// URI (FileProvider URI)
    */
   static async install(apkUri: string): Promise<void> {
@@ -37,7 +37,7 @@ export abstract class ApkInstaller {
   }
 
   /**
-   * Get app version info
+   * 앱 버전 정보 조회
    */
   static async getVersionInfo(): Promise<VersionInfo> {
     return apkInstallerPlugin.getVersionInfo();

package/src/AutoUpdate.ts

@@ -36,19 +36,19 @@ export abstract class AutoUpdate {
               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}
+      APK 파일을 다시 다운로드하여 설치해야 합니다(${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.");
+      throw new Error("Android만 지원됩니다.");
     }
 
     let granted: boolean;
@@ -60,22 +60,22 @@ export abstract class AutoUpdate {
       granted = result.granted;
     } catch (err) {
       // eslint-disable-next-line no-console
-      console.error("[AutoUpdate] checkPermissions manifest check failed:", err);
+      console.error("[AutoUpdate] checkPermissions manifest 확인 실패:", err);
       this._throwAboutReinstall(2, targetHref);
-      return; // unreachable — _throwAboutReinstall always throws
+      return; // 도달 불가 — _throwAboutReinstall은 항상 throw함
     }
 
     if (!granted) {
       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>
+        <button onclick="location.reload()">재시도</button>
       `);
       await ApkInstaller.requestPermissions();
-      // Wait up to 5 minutes (300 seconds) - time for user to grant permission in settings
+      // 최대 5분(300초) 대기 - 사용자가 설정에서 권한을 부여할 시간
       await wait.until(
         async () => {
           const result = await ApkInstaller.checkPermissions();
@@ -92,12 +92,12 @@ export abstract class AutoUpdate {
     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>
+      <button onclick="location.reload()">재시도</button>
     `);
     const apkFileUri = await FileSystem.getUri(apkFilePath);
     await ApkInstaller.install(apkFileUri);
@@ -105,54 +105,54 @@ export abstract class AutoUpdate {
 
   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
+    await new Promise(() => {}); // 무한 대기
   }
 
   static async run(opt: { log: (messageHtml: string) => void; serviceClient: ServiceClient }) {
     try {
-      opt.log(`Checking latest version...`);
+      opt.log(`최신 버전 확인 중...`);
 
-      // 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.");
+        console.log("서버에서 최신 버전 정보를 가져오지 못했습니다.");
         return;
       }
 
-      opt.log(`Checking permission...`);
+      opt.log(`권한 확인 중...`);
       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");
+        console.log("유효하지 않은 semver 버전이므로 업데이트 확인을 건너뜁니다");
         return;
       }
       if (!semver.gt(serverVersionInfo.version, currentVersionInfo.versionName)) {
         return;
       }
 
-      opt.log(`Downloading latest version file...`);
+      opt.log(`최신 버전 파일 다운로드 중...`);
       const buffer = await fetchUrlBytes(
         opt.serviceClient.hostUrl + serverVersionInfo.downloadPath,
         {
@@ -160,7 +160,7 @@ export abstract class AutoUpdate {
             const progressText = ((progress.receivedLength * 100) / progress.contentLength).toFixed(
               2,
             );
-            opt.log(`Downloading latest version file...(${progressText}%)`);
+            opt.log(`최신 버전 파일 다운로드 중...(${progressText}%)`);
           },
         },
       );
@@ -178,12 +178,12 @@ export abstract class AutoUpdate {
 
   static async runByExternalStorage(opt: { log: (messageHtml: string) => void; dirPath: string }) {
     try {
-      opt.log(`Checking permission...`);
+      opt.log(`권한 확인 중...`);
       await this._checkPermission(opt.log);
 
-      opt.log(`Checking latest version...`);
+      opt.log(`최신 버전 확인 중...`);
 
-      // Get versions
+      // 버전 목록 조회
       const externalPath = await FileSystem.getStoragePath("external");
       const fileInfos = await FileSystem.readdir(path.join(externalPath, opt.dirPath));
 
@@ -198,7 +198,7 @@ export abstract class AutoUpdate {
           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(
@@ -206,23 +206,23 @@ export abstract class AutoUpdate {
         "*",
       );
 
-      // Return if no valid semver versions
+      // 유효한 semver 버전이 없으면 반환
       if (latestVersion == null) {
         // eslint-disable-next-line no-console
-        console.log("No valid semver version files found.");
+        console.log("유효한 semver 버전 파일을 찾을 수 없습니다.");
         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");
+        console.log("유효하지 않은 semver 버전이므로 업데이트 확인을 건너뜁니다");
         return;
       }
       if (!semver.gt(latestVersion, currentVersionInfo.versionName)) {

package/src/index.ts

@@ -1,6 +1,6 @@
-// APK Installer
+// APK 설치
 export * from "./ApkInstaller";
 export * from "./ApkInstallerPlugin";
 
-// Auto Update
+// 자동 업데이트
 export * from "./AutoUpdate";

package/src/web/ApkInstallerWeb.ts

@@ -3,17 +3,17 @@ import type { ApkInstallerPlugin, VersionInfo } from "../ApkInstallerPlugin";
 
 export class ApkInstallerWeb extends WebPlugin implements ApkInstallerPlugin {
   install(_options: { uri: string }): Promise<void> {
-    alert("[ApkInstaller] APK installation is not supported in web environment.");
+    alert("[ApkInstaller] 웹 환경에서는 APK 설치를 지원하지 않습니다.");
     return Promise.resolve();
   }
 
   checkPermissions(): Promise<{ granted: boolean; manifest: boolean }> {
-    // Skip permission check on web
+    // 웹에서는 권한 확인 생략
     return Promise.resolve({ granted: true, manifest: true });
   }
 
   async requestPermissions(): Promise<void> {
-    // No-op on web
+    // 웹에서는 동작 없음
   }
 
   getVersionInfo(): Promise<VersionInfo> {

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

@@ -1,118 +0,0 @@
-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 checkPermissions(PluginCall call) {
-        // Check granted
-        boolean granted;
-        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
-            granted = getContext().getPackageManager().canRequestPackageInstalls();
-        } else {
-            granted = true;
-        }
-
-        // Check manifest
-        boolean manifest = false;
-        try {
-            Context context = getContext();
-            String targetPermission = "android.permission.REQUEST_INSTALL_PACKAGES";
-            String[] requestedPermissions = context.getPackageManager()
-                .getPackageInfo(context.getPackageName(), PackageManager.GET_PERMISSIONS)
-                .requestedPermissions;
-            if (requestedPermissions != null) {
-                for (String perm : requestedPermissions) {
-                    if (targetPermission.equals(perm)) {
-                        manifest = true;
-                        break;
-                    }
-                }
-            }
-        } catch (Exception e) {
-            Log.e(TAG, "checkPermissions manifest check failed", e);
-        }
-
-        JSObject ret = new JSObject();
-        ret.put("granted", granted);
-        ret.put("manifest", manifest);
-        call.resolve(ret);
-    }
-
-    @PluginMethod
-    public void requestPermissions(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 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/env.d.js

@@ -1 +0,0 @@
-//# sourceMappingURL=env.d.js.map

package/dist/env.d.js.map

@@ -1,6 +0,0 @@
-{
-  "version": 3,
-  "sources": [],
-  "mappings": "",
-  "names": []
-}