react-native-custom-ota 1.0.2 → 1.0.3

package/lib/typescript/useCustomOTA.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useCustomOTA = useCustomOTA;
+const react_1 = require("react");
+const manager_1 = require("./manager");
+const types_1 = require("./types");
+function useCustomOTA() {
+    const [isChecking, setIsChecking] = (0, react_1.useState)(false);
+    const [isDownloading, setIsDownloading] = (0, react_1.useState)(false);
+    const [progress, setProgress] = (0, react_1.useState)({
+        totalBytes: 0,
+        receivedBytes: 0,
+        percentage: 0,
+        progress: 0
+    });
+    const [syncStatus, setSyncStatus] = (0, react_1.useState)(types_1.SyncStatus.UP_TO_DATE);
+    const [detailedStatus, setDetailedStatus] = (0, react_1.useState)(types_1.DetailedStatus.IDLE);
+    const [statusText, setStatusText] = (0, react_1.useState)("");
+    const [activeMetadata, setActiveMetadata] = (0, react_1.useState)(null);
+    const refreshMetadata = (0, react_1.useCallback)(async () => {
+        try {
+            const meta = await manager_1.CustomOTAManager.getUpdateMetadata();
+            setActiveMetadata(meta);
+            return meta;
+        }
+        catch {
+            return {
+                currentVersion: "0.0.0",
+                previousVersion: null,
+                pending: false,
+                ready: true,
+                failedVersions: []
+            };
+        }
+    }, []);
+    (0, react_1.useEffect)(() => {
+        refreshMetadata();
+        // Đăng ký nhận sự kiện tiến độ toàn cục
+        const removeProgressListener = manager_1.CustomOTAManager.addProgressListener((prog) => {
+            setProgress(prog);
+            setIsDownloading(true);
+            setDetailedStatus(types_1.DetailedStatus.DOWNLOADING);
+            setStatusText(`Đang tải bản cập nhật: ${prog.percentage}%`);
+        });
+        const removeStatusListener = manager_1.CustomOTAManager.addDetailedStatusListener((status, msg) => {
+            setDetailedStatus(status);
+            if (msg)
+                setStatusText(msg);
+            if (status === types_1.DetailedStatus.DOWNLOADING) {
+                setIsDownloading(true);
+            }
+            else if (status === types_1.DetailedStatus.COMPLETED || status === types_1.DetailedStatus.ERROR) {
+                setIsDownloading(false);
+                refreshMetadata();
+            }
+        });
+        return () => {
+            removeProgressListener();
+            removeStatusListener();
+        };
+    }, [refreshMetadata]);
+    const checkForUpdate = (0, react_1.useCallback)(async (options) => {
+        setIsChecking(true);
+        setDetailedStatus(types_1.DetailedStatus.CHECKING);
+        setStatusText("Đang kiểm tra phiên bản mới...");
+        try {
+            const update = await manager_1.CustomOTAManager.checkForUpdate(options);
+            if (update && update.updateAvailable) {
+                setDetailedStatus(types_1.DetailedStatus.UPDATE_AVAILABLE);
+                setStatusText(`Tìm thấy bản cập nhật mới v${update.otaVersion}`);
+            }
+            else {
+                setDetailedStatus(types_1.DetailedStatus.IDLE);
+                setStatusText("Ứng dụng đang ở phiên bản mới nhất");
+            }
+            return update;
+        }
+        catch (err) {
+            setDetailedStatus(types_1.DetailedStatus.ERROR);
+            setStatusText(err.message || "Lỗi khi kiểm tra cập nhật");
+            throw err;
+        }
+        finally {
+            setIsChecking(false);
+        }
+    }, []);
+    const sync = (0, react_1.useCallback)(async (options) => {
+        setIsChecking(true);
+        setProgress({ totalBytes: 0, receivedBytes: 0, percentage: 0, progress: 0 });
+        try {
+            const status = await manager_1.CustomOTAManager.sync(options, (s) => setSyncStatus(s), (prog) => setProgress(prog));
+            setSyncStatus(status);
+            await refreshMetadata();
+            return status;
+        }
+        finally {
+            setIsChecking(false);
+            setIsDownloading(false);
+        }
+    }, [refreshMetadata]);
+    const restartApp = (0, react_1.useCallback)(async () => {
+        await manager_1.CustomOTAManager.restartApp();
+    }, []);
+    return {
+        isChecking,
+        isDownloading,
+        progress,
+        syncStatus,
+        detailedStatus,
+        statusText,
+        activeMetadata,
+        activeVersion: activeMetadata?.currentVersion || "0.0.0",
+        checkForUpdate,
+        sync,
+        restartApp,
+        refreshMetadata
+    };
+}
+exports.default = useCustomOTA;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-custom-ota",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Self-hosted OTA (Over-The-Air) update library for React Native with automatic rollback, similar to react-native-code-push",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",

package/src/ProgressModal.tsx

@@ -0,0 +1,214 @@
+import React from "react";
+import {
+  Modal,
+  StyleSheet,
+  Text,
+  View,
+  ActivityIndicator,
+  Dimensions
+} from "react-native";
+import { DownloadProgress } from "./types";
+
+export interface OTAProgressModalProps {
+  /** Trạng thái hiển thị modal */
+  visible: boolean;
+  /** Thông tin tiến độ tải (object hoặc số thập phân 0.0 - 1.0) */
+  progress?: DownloadProgress | number;
+  /** Tiêu đề modal (Mặc định: 'Cập nhật ứng dụng') */
+  title?: string;
+  /** Thông điệp trạng thái hiện tại (vd: 'Đang tải gói cập nhật...') */
+  statusText?: string;
+  /** Phiên bản đang được tải về (vd: '1.0.9') */
+  version?: string;
+}
+
+export function formatBytes(bytes: number, decimals = 1): string {
+  if (!bytes || bytes <= 0) return "0 B";
+  const k = 1024;
+  const dm = decimals < 0 ? 0 : decimals;
+  const sizes = ["B", "KB", "MB", "GB"];
+  const i = Math.floor(Math.log(bytes) / Math.log(k));
+  return `${parseFloat((bytes / Math.pow(k, i)).toFixed(dm))} ${sizes[i]}`;
+}
+
+export const OTAProgressModal: React.FC<OTAProgressModalProps> = ({
+  visible,
+  progress,
+  title = "Cập nhật ứng dụng",
+  statusText = "Đang tải bản cập nhật...",
+  version
+}) => {
+  // Chuẩn hóa dữ liệu tiến độ
+  let percent = 0;
+  let receivedBytes = 0;
+  let totalBytes = 0;
+
+  if (typeof progress === "number") {
+    percent = Math.min(100, Math.max(0, Math.round(progress * 100)));
+  } else if (progress && typeof progress === "object") {
+    percent = Math.min(100, Math.max(0, Math.round(progress.percentage || 0)));
+    receivedBytes = progress.receivedBytes || 0;
+    totalBytes = progress.totalBytes || 0;
+  }
+
+  const bytesInfo = totalBytes > 0
+    ? `${formatBytes(receivedBytes)} / ${formatBytes(totalBytes)}`
+    : "";
+
+  return (
+    <Modal
+      transparent
+      animationType="fade"
+      visible={visible}
+      statusBarTranslucent
+    >
+      <View style={styles.overlay}>
+        <View style={styles.card}>
+          {/* Header */}
+          <View style={styles.header}>
+            <View style={styles.iconContainer}>
+              <Text style={styles.iconText}>⚡</Text>
+            </View>
+            <View style={styles.headerTextContainer}>
+              <Text style={styles.title}>{title}</Text>
+              {version ? (
+                <Text style={styles.versionBadge}>Phiên bản v{version}</Text>
+              ) : null}
+            </View>
+          </View>
+
+          {/* Status Message */}
+          <Text style={styles.statusText}>{statusText}</Text>
+
+          {/* Progress Bar */}
+          <View style={styles.progressBarTrack}>
+            <View style={[styles.progressBarFill, { width: `${percent}%` }]} />
+          </View>
+
+          {/* Progress Details */}
+          <View style={styles.detailsRow}>
+            <Text style={styles.percentageText}>{percent}%</Text>
+            {bytesInfo ? (
+              <Text style={styles.bytesText}>{bytesInfo}</Text>
+            ) : null}
+          </View>
+
+          {/* Footer note */}
+          <View style={styles.footer}>
+            <ActivityIndicator size="small" color="#38bdf8" style={{ marginRight: 8 }} />
+            <Text style={styles.footerText}>
+              Vui lòng không đóng ứng dụng...
+            </Text>
+          </View>
+        </View>
+      </View>
+    </Modal>
+  );
+};
+
+const styles = StyleSheet.create({
+  overlay: {
+    flex: 1,
+    backgroundColor: "rgba(0, 0, 0, 0.72)",
+    justifyContent: "center",
+    alignItems: "center",
+    paddingHorizontal: 24
+  },
+  card: {
+    width: "100%",
+    maxWidth: 380,
+    backgroundColor: "#0f172a",
+    borderRadius: 20,
+    padding: 24,
+    borderWidth: 1,
+    borderColor: "rgba(255, 255, 255, 0.12)",
+    shadowColor: "#000",
+    shadowOffset: { width: 0, height: 12 },
+    shadowOpacity: 0.5,
+    shadowRadius: 20,
+    elevation: 16
+  },
+  header: {
+    flexDirection: "row",
+    alignItems: "center",
+    marginBottom: 16
+  },
+  iconContainer: {
+    width: 44,
+    height: 44,
+    borderRadius: 12,
+    backgroundColor: "rgba(56, 189, 248, 0.15)",
+    justifyContent: "center",
+    alignItems: "center",
+    marginRight: 14,
+    borderWidth: 1,
+    borderColor: "rgba(56, 189, 248, 0.3)"
+  },
+  iconText: {
+    fontSize: 22
+  },
+  headerTextContainer: {
+    flex: 1
+  },
+  title: {
+    fontSize: 18,
+    fontWeight: "700",
+    color: "#f8fafc",
+    letterSpacing: 0.2
+  },
+  versionBadge: {
+    fontSize: 12,
+    color: "#38bdf8",
+    fontWeight: "600",
+    marginTop: 2
+  },
+  statusText: {
+    fontSize: 14,
+    color: "#94a3b8",
+    marginBottom: 16,
+    lineHeight: 20
+  },
+  progressBarTrack: {
+    height: 10,
+    backgroundColor: "rgba(255, 255, 255, 0.08)",
+    borderRadius: 999,
+    overflow: "hidden",
+    marginBottom: 10
+  },
+  progressBarFill: {
+    height: "100%",
+    backgroundColor: "#38bdf8",
+    borderRadius: 999
+  },
+  detailsRow: {
+    flexDirection: "row",
+    justifyContent: "space-between",
+    alignItems: "center",
+    marginBottom: 20
+  },
+  percentageText: {
+    fontSize: 16,
+    fontWeight: "800",
+    color: "#38bdf8"
+  },
+  bytesText: {
+    fontSize: 13,
+    color: "#64748b",
+    fontWeight: "500"
+  },
+  footer: {
+    flexDirection: "row",
+    alignItems: "center",
+    justifyContent: "center",
+    paddingTop: 12,
+    borderTopWidth: 1,
+    borderTopColor: "rgba(255, 255, 255, 0.06)"
+  },
+  footerText: {
+    fontSize: 12,
+    color: "#64748b",
+    fontWeight: "500"
+  }
+});
+
+export default OTAProgressModal;

package/src/hoc.tsx

@@ -1,12 +1,44 @@
-import React, { ComponentType, useEffect } from "react";
-import { AppState, AppStateStatus } from "react-native";
+import React, { ComponentType, useEffect, useState } from "react";
+import { AppState, AppStateStatus, View } from "react-native";
 import { CustomOTAManager } from "./manager";
-import { CheckFrequency, SyncOptions } from "./types";
+import { CheckFrequency, DownloadProgress, SyncOptions, DetailedStatus } from "./types";
+import { OTAProgressModal } from "./ProgressModal";
 
 export function withCustomOTA(options: SyncOptions) {
   return function <P extends object>(WrappedComponent: ComponentType<P>): ComponentType<P> {
     return function CustomOTAWrapper(props: P) {
+      const [isDownloading, setIsDownloading] = useState(false);
+      const [progress, setProgress] = useState<DownloadProgress>({
+        totalBytes: 0,
+        receivedBytes: 0,
+        percentage: 0,
+        progress: 0
+      });
+      const [statusText, setStatusText] = useState("Đang tải bản cập nhật...");
+
       useEffect(() => {
+        let removeProg: (() => void) | undefined;
+        let removeStatus: (() => void) | undefined;
+
+        if (options.showProgressModal) {
+          removeProg = CustomOTAManager.addProgressListener((p) => {
+            setProgress(p);
+            setIsDownloading(true);
+          });
+          removeStatus = CustomOTAManager.addDetailedStatusListener((s, msg) => {
+            if (msg) setStatusText(msg);
+            if (
+              s === DetailedStatus.DOWNLOADING ||
+              s === DetailedStatus.VERIFYING ||
+              s === DetailedStatus.INSTALLING
+            ) {
+              setIsDownloading(true);
+            } else if (s === DetailedStatus.COMPLETED || s === DetailedStatus.ERROR) {
+              setIsDownloading(false);
+            }
+          });
+        }
+
         // Tự động kiểm tra cập nhật khi app khởi động
         if (options.checkFrequency !== CheckFrequency.MANUAL) {
           CustomOTAManager.sync(options);
@@ -24,11 +56,31 @@ export function withCustomOTA(options: SyncOptions) {
           );
           return () => {
             subscription.remove();
+            removeProg?.();
+            removeStatus?.();
           };
         }
+
+        return () => {
+          removeProg?.();
+          removeStatus?.();
+        };
       }, []);
 
-      return <WrappedComponent {...props} />;
+      return (
+        <View style={{ flex: 1 }}>
+          <WrappedComponent {...props} />
+          {options.showProgressModal && (
+            <OTAProgressModal
+              visible={isDownloading}
+              progress={progress}
+              statusText={statusText}
+            />
+          )}
+        </View>
+      );
     };
   };
 }
+
+export default withCustomOTA;

package/src/index.ts

@@ -1,10 +1,14 @@
 import { CustomOTAManager } from "./manager";
 import { withCustomOTA } from "./hoc";
+import { OTAProgressModal } from "./ProgressModal";
+import { useCustomOTA } from "./useCustomOTA";
 
 export * from "./types";
 export * from "./manager";
 export * from "./hoc";
 export * from "./storage";
+export * from "./ProgressModal";
+export * from "./useCustomOTA";
 
 const CustomOTA = {
   sync: CustomOTAManager.sync.bind(CustomOTAManager),
@@ -13,7 +17,11 @@ const CustomOTA = {
   restartApp: CustomOTAManager.restartApp.bind(CustomOTAManager),
   getUpdateMetadata: CustomOTAManager.getUpdateMetadata.bind(CustomOTAManager),
   markReady: CustomOTAManager.markReady.bind(CustomOTAManager),
-  wrap: withCustomOTA
+  addProgressListener: CustomOTAManager.addProgressListener.bind(CustomOTAManager),
+  addDetailedStatusListener: CustomOTAManager.addDetailedStatusListener.bind(CustomOTAManager),
+  wrap: withCustomOTA,
+  ProgressModal: OTAProgressModal,
+  useCustomOTA: useCustomOTA
 };
 
 export default CustomOTA;

package/src/manager.ts

@@ -3,12 +3,14 @@ import RNFS from "react-native-fs";
 import { OTAUpdater } from "./native";
 import { BACKUP_DIR, CURRENT_DIR, TEMP_DIR, ensureOTADirs, readState, writeState } from "./storage";
 import {
+  DownloadProgress,
   InstallMode,
   LocalPackage,
   RemotePackage,
   SyncOptions,
   SyncStatus,
-  UpdateDialogOptions
+  UpdateDialogOptions,
+  DetailedStatus
 } from "./types";
 
 export class CustomOTAManager {
@@ -17,9 +19,55 @@ export class CustomOTAManager {
     optionalUpdateMessage: "Đã có bản cập nhật ứng dụng mới. Bạn có muốn cài đặt ngay bây giờ?",
     mandatoryUpdateMessage: "Đã có bản cập nhật bắt buộc. Vui lòng cài đặt để tiếp tục sử dụng.",
     optionalInstallButtonLabel: "Cập nhật",
-    optionalIgnoreButtonLabel: "Để sau"
+    optionalIgnoreButtonLabel: "Để sau",
+    showProgressModal: true
   };
 
+  private static progressListeners = new Set<(progress: DownloadProgress) => void>();
+  private static detailedStatusListeners = new Set<(status: DetailedStatus, message?: string) => void>();
+
+  /**
+   * Đăng ký lắng nghe tiến độ tải về toàn cục
+   * @returns Hàm hủy đăng ký (unsubscribe)
+   */
+  static addProgressListener(listener: (progress: DownloadProgress) => void): () => void {
+    this.progressListeners.add(listener);
+    return () => {
+      this.progressListeners.delete(listener);
+    };
+  }
+
+  /**
+   * Đăng ký lắng nghe trạng thái chi tiết của quá trình OTA
+   * @returns Hàm hủy đăng ký (unsubscribe)
+   */
+  static addDetailedStatusListener(listener: (status: DetailedStatus, message?: string) => void): () => void {
+    this.detailedStatusListeners.add(listener);
+    return () => {
+      this.detailedStatusListeners.delete(listener);
+    };
+  }
+
+  private static emitProgress(progress: DownloadProgress) {
+    for (const listener of this.progressListeners) {
+      try {
+        listener(progress);
+      } catch (e) {
+        console.warn("[CustomOTA] Error in progress listener:", e);
+      }
+    }
+  }
+
+  private static emitDetailedStatus(status: DetailedStatus, message?: string) {
+    for (const listener of this.detailedStatusListeners) {
+      try {
+        listener(status, message);
+      } catch (e) {
+        console.warn("[CustomOTA] Error in detailed status listener:", e);
+      }
+    }
+  }
+
   /**
    * Đánh dấu bản build OTA hiện tại đã khởi động thành công.
    * Xóa bản backup trước đó và tắt cờ pending.
@@ -61,7 +109,7 @@ export class CustomOTAManager {
   }
 
   /**
-   * Kiểm tra xem server có bản cập nhật mới hay không.
+   * Kiểm tra xem có bản cập nhật mới từ OTA Server hay không.
    */
   static async checkForUpdate(options: {
     serverUrl: string;
@@ -140,11 +188,11 @@ export class CustomOTAManager {
   }
 
   /**
-   * Tải và cài đặt bản cập nhật.
+   * Tải và cài đặt bản cập nhật với theo dõi tiến độ chi tiết.
    */
   static async downloadAndInstall(
     update: RemotePackage,
-    onProgress?: (progress: number) => void,
+    onProgress?: ((progress: DownloadProgress) => void) | ((progressValue: number) => void),
     installMode?: InstallMode
   ): Promise<boolean> {
     const version = update.otaVersion || update.version;
@@ -157,34 +205,58 @@ export class CustomOTAManager {
       throw new Error(`Invalid update package metadata: missing ${missingFields}`);
     }
 
+    this.emitDetailedStatus(DetailedStatus.DOWNLOADING, `Bắt đầu tải bản cập nhật v${version}...`);
+
     const zipPath = `${TEMP_DIR}/update-${version}.zip`;
     await RNFS.unlink(zipPath).catch(() => {});
 
-    // Download zip file
+    // Download zip file với theo dõi byte chính xác
     const downloadRes = RNFS.downloadFile({
       fromUrl: update.downloadUrl.startsWith("http") ? update.downloadUrl : `${update.downloadUrl}`,
       toFile: zipPath,
       progressDivider: 1,
       progress: ({ bytesWritten, contentLength }) => {
-        if (contentLength > 0 && onProgress) {
-          onProgress(bytesWritten / contentLength);
+        const total = contentLength > 0 ? contentLength : (update.size || 0);
+        const percent = total > 0 ? Math.min(100, Math.round((bytesWritten / total) * 100)) : 0;
+        const progressVal = total > 0 ? Math.min(1, bytesWritten / total) : 0;
+
+        const progressObj: DownloadProgress = {
+          totalBytes: total,
+          receivedBytes: bytesWritten,
+          percentage: percent,
+          progress: progressVal
+        };
+
+        if (onProgress) {
+          // Callback nhận cả object lẫn hỗ trợ kiểu cũ nhận số
+          try {
+            (onProgress as any)(progressObj, progressVal);
+          } catch {
+            (onProgress as any)(progressVal);
+          }
         }
+
+        this.emitProgress(progressObj);
       }
     });
 
     const res = await downloadRes.promise;
     if (res.statusCode < 200 || res.statusCode >= 300) {
+      this.emitDetailedStatus(DetailedStatus.ERROR, `Tải thất bại với mã lỗi HTTP ${res.statusCode}`);
       throw new Error(`Download failed with status ${res.statusCode}`);
     }
 
     // SHA-256 verification
+    this.emitDetailedStatus(DetailedStatus.VERIFYING, "Đang kiểm tra tính toàn vẹn (SHA-256)...");
     const actualHash = await RNFS.hash(zipPath, "sha256");
     if (actualHash.toLowerCase() !== update.sha256.toLowerCase()) {
       await RNFS.unlink(zipPath).catch(() => {});
+      this.emitDetailedStatus(DetailedStatus.ERROR, "Mã băm SHA-256 không trùng khớp!");
       throw new Error(`SHA-256 Checksum mismatch! Expected ${update.sha256}, got ${actualHash}`);
     }
 
     // Unpack temp directory
+    this.emitDetailedStatus(DetailedStatus.INSTALLING, "Đang giải nén và nạp gói cập nhật...");
     const tempDir = `${TEMP_DIR}/${version}`;
     await RNFS.unlink(tempDir).catch(() => {});
     await RNFS.mkdir(tempDir);
@@ -218,6 +290,8 @@ export class CustomOTAManager {
 
     await RNFS.unlink(zipPath).catch(() => {});
 
+    this.emitDetailedStatus(DetailedStatus.COMPLETED, `Đã cài đặt bản cập nhật v${version} thành công!`);
+
     if (installMode === InstallMode.IMMEDIATE) {
       await this.restartApp();
     }
@@ -231,7 +305,7 @@ export class CustomOTAManager {
   static async sync(
     options: SyncOptions,
     syncStatusCallback?: (status: SyncStatus) => void,
-    downloadProgressCallback?: (progress: number) => void
+    downloadProgressCallback?: ((progress: DownloadProgress) => void) | ((progressValue: number) => void)
   ): Promise<SyncStatus> {
     try {
       // 1. Tự động markReady khi khởi động

package/src/types.ts

@@ -7,6 +7,17 @@ export enum SyncStatus {
   ERROR = -1
 }
 
+export enum DetailedStatus {
+  IDLE = "IDLE",
+  CHECKING = "CHECKING",
+  UPDATE_AVAILABLE = "UPDATE_AVAILABLE",
+  DOWNLOADING = "DOWNLOADING",
+  VERIFYING = "VERIFYING",
+  INSTALLING = "INSTALLING",
+  COMPLETED = "COMPLETED",
+  ERROR = "ERROR"
+}
+
 export enum CheckFrequency {
   ON_APP_START = "ON_APP_START",
   ON_APP_RESUME = "ON_APP_RESUME",
@@ -18,12 +29,31 @@ export enum InstallMode {
   ON_NEXT_RESTART = "ON_NEXT_RESTART"
 }
 
+/**
+ * Thông tin tiến độ tải về bản cập nhật
+ */
+export interface DownloadProgress {
+  /** Tổng số byte cần tải */
+  totalBytes: number;
+  /** Số byte đã tải về máy */
+  receivedBytes: number;
+  /** Tỷ lệ hoàn thành từ 0 đến 100 (%) */
+  percentage: number;
+  /** Giá trị tỷ lệ từ 0.0 đến 1.0 (tương thích CodePush / Progress Bar) */
+  progress: number;
+}
+
+export type DownloadProgressCallback = (progress: DownloadProgress) => void;
+export type DetailedStatusCallback = (status: DetailedStatus, message?: string) => void;
+
 export interface UpdateDialogOptions {
   title?: string;
   optionalUpdateMessage?: string;
   mandatoryUpdateMessage?: string;
   optionalInstallButtonLabel?: string;
   optionalIgnoreButtonLabel?: string;
+  /** Hiển thị modal tiến độ tải sau khi người dùng bấm cập nhật */
+  showProgressModal?: boolean;
 }
 
 export interface SyncOptions {
@@ -35,6 +65,8 @@ export interface SyncOptions {
   installMode?: InstallMode;
   mandatoryInstallMode?: InstallMode;
   updateDialog?: boolean | UpdateDialogOptions;
+  /** Tự động hiển thị modal tiến độ tải cập nhật */
+  showProgressModal?: boolean;
   checkFrequency?: CheckFrequency;
 }