Récupérer les informations de l'APK Service

Certains clients ou applications tierces peuvent avoir besoin de connaître la version exacte de l'application de service Pulse (pulse-service.apk) hébergée sur le serveur avant de la télécharger.

Une nouvelle route a été ajoutée pour exposer ces métadonnées sans avoir à télécharger le fichier complet.

Endpoint

GET /pulse-build/info

Cette route ne nécessite pas d'authentification spécifique (sauf si le serveur est configuré autrement pour les routes publiques), car elle sert à la distribution de l'agent de service.

Structure de la réponse

L'objet retourné est un JSON contenant les informations extraites directement du manifest de l'APK :

{
  "package": "com.pulse.mdm.service",
  "versionCode": 2,
  "versionName": "1.0"
}

Champs

• package : Le nom du package Android (ex: com.pulse.mdm.service).

• versionCode : Un entier représentant la version interne du build. C'est ce champ qui doit être utilisé pour vérifier programmaticquement si une mise à jour est nécessaire.

• versionName : La chaîne de caractères de la version (ex: 1.2.0), utile pour l'affichage utilisateur.

Cas d'usage : Vérification de mise à jour

Avant de lancer le téléchargement via /pulse-build ou /pulse-build/:codeVersion, vous pouvez interroger /pulse-build/info pour comparer le versionCode local avec celui du serveur.

Exemple (Pseudo-code)

// 1. Obtenir la version locale
const currentVersionCode = 1;

// 2. Interroger le serveur
const remoteInfo = await fetch('https://mdm.example.com/pulse-build/info').then((r) => r.json());

// 3. Comparer
if (remoteInfo.versionCode > currentVersionCode) {
  console.log('Mise à jour disponible : ' + remoteInfo.versionName);
  // Télécharger la nouvelle version
  downloadApk();
} else {
  console.log("L'application est à jour.");
}