Auto-mise à jour

Copiez un prompt de configuration avec les étapes d'installation et la guide markdown complet pour ce plugin.

Cette documentation expliquera comment exécuter votre serveur d'auto-mise à jour.

Servir votre bundle

Assurez-vous que votre bundle est servi sur HTTPS, et que le serveur a les bonnes en-têtes CORS pour permettre à l'application de télécharger la mise à jour. Exemple : https://myserver.com/app/updates/updates.json

Si vous êtes inconnu de la mise en service d'un bundle, nous vous recommandons de tenter Capgo Cloud ou de consulter un exemple ici :

Serving a Bundle

Configuration

Ajoutez un updateUrl à votre capacitor.config.json.

{
  "plugins": {
    "CapacitorUpdater": {
      "updateUrl": "https://myserver.com/app/updates/updates.json",
    }
  }
}

Mise à jour API

Le plugin effectuera une requête POST vers votre API chaque fois que l'application est ouverte, avec le corps suivant :

interface AppInfos {
    "platform": "ios" | "android" | "electron",
    "device_id": "UUID_of_device_unique_by_install",
    "app_id": "APPID_FROM_CAPACITOR_CONFIG",
    "custom_id": "your_custom_id_set_on_runtime",
    "plugin_version": "PLUGIN_VERSION",
    "version_build": "VERSION_NUMBER_FROM_NATIVE_CODE",
    "version_code": "VERSION_CODE_FROM_NATIVE_CODE",
    "version_name": "LAST_DOWNLOADER_VERSION" | "builtin"
    "version_os": "VERSION_OF_SYSTEM_OS",
    "is_emulator": boolean,
    "is_prod": boolean,
}

Le serveur API devrait répondre, au format JSON, au plugin de mise à jour capacitor. Si une mise à jour est nécessaire :

{
"version": "1.2.3",
"url": "https://myserver.com/app/updates/my-new-app-2.0.0.zip",
"checksum": "sha256_checksum_of_bundle"
}

En mode de mise à jour automatique, le serveur devrait comparer les versions et retourner la bonne une, si la clé URL est présente, le plugin démarre le processus de téléchargement.

Si vous ajoutez les clés « message » et « error », la version ne sera pas définie, et le message sera affiché dans les journaux à la place.

version La clé doit être dans semver le format.

Le zip doit contenir index.html comme un fichier au niveau de la racine, ou uniquement un dossier au niveau de la racine avec index.html à l'intérieur.

You pouvez utiliser la commande du CLI pour zipper votre bundle :

npx @capgo/cli bundle zip --path [/path/to/my/bundle]

Génération du checksum du Bundle

Important : Vous devez utiliser le Capgo CLI pour créer votre fichier zip de bundle. Le plugin Capgo nécessite un format et une structure zip spécifiques qui ne sont garantis que lorsque l'on utilise l'outil officiel CLI. Les utilitaires zip standard peuvent créer des archives incompatibles.

Pour générer le checksum de votre bundle, utilisez la commande Capgo CLI zip avec la --json drapeau :

npx @capgo/cli bundle zip [appId] --json

Cette commande fera :

Créez un fichier zip compatible avec le plugin Capgo
Générez le checksum SHA256 pour la vérification de l'intégrité
Affichez les informations du bundle sous format JSON

Exemple de sortie :

{
  "version": "1.2.3",
  "checksum": "a1b2c3d4e5f6789...",
  "size": 1234567
}

Utilisez la checksum valeur de cette sortie dans votre réponse API pour vous assurer que le plugin peut vérifier l'intégrité du bundle avant l'installation.

Continuez de l'Auto Mise à Jour

pour planifier la migration et les opérations d'entreprise, connectez-le avec Pour utiliser l'Auto Mise à Jour Pour utiliser l'Auto Mise à Jour En utilisant @capgo/capacitor-moteur de mise à jour pour la capacité native dans En utilisant @capgo/capacitor-moteur de mise à jour, Capgo Entreprise pour le flux de travail du produit dans Capgo Entreprise, Alternatives d'extension d'entreprise d'Ionic pour le flux de travail du produit dans Alternatives d'extension d'entreprise d'Ionic, Capgo Alternatives pour le flux de travail du produit dans Capgo Alternatives, et Capgo Conseil pour le flux de travail du produit dans Capgo Conseil.