Comment créer votre propre source AltStore ou SideStore

ParScarlet iOS Team Mis à jour le

Une source AltStore ou SideStore est le lien qui permet à vos applications d’apparaître dans ces stores. Ce guide explique comment en créer une à partir de la documentation officielle des développeurs d’AltStore, que SideStore suit également. Dernière vérification : 28 octobre 2026, sur la base des pages Make a Source, Updating Apps, Distribute with AltStore Classic et AltSource CLI d’AltStore, ainsi que de la page App Sources de SideStore.

Les risques en premier

  • Une source ne fait que répertorier des applications. Ce sont les fichiers IPA vers lesquels elle pointe qui sont installés, donc ne listez que des applications que vous avez créées vous-même ou que vous êtes autorisé à partager. Republier les applications payantes d’autres personnes constitue une violation du droit d’auteur.
  • Toute personne pouvant modifier votre fichier JSON ou vos liens de téléchargement peut changer ce que vos utilisateurs installent. Utilisez un compte avec authentification à deux facteurs sur l’hébergeur, et ne pointez pas vers des fichiers IPA situés sur des serveurs que vous ne contrôlez pas.
  • Vos utilisateurs installent toujours avec leur propre Apple ID, donc les limites du compte gratuit s’appliquent à eux : 3 applications à la fois et une signature valable 7 jours.
  • AltStore vérifie les autorisations. Sa documentation indique qu’il « refusera d’installer toute application dont les autorisations ne correspondent pas » à ce que la source indique, donc une fiche incomplète empêche l’installation.

Qu’est-ce qu’une source

La documentation d’AltStore décrit une source comme « simplement un fichier JSON auto-hébergé contenant des métadonnées de base sur vos applications ». Vous placez ce fichier sur n’importe quel hébergeur web qui le sert via une URL HTTPS stable, vous mettez vos fichiers IPA en ligne juste à côté, puis vous partagez l’URL. Plusieurs sources de notre liste de sources AltStore et SideStore sont hébergées sur GitHub Pages ou en tant que fichier brut dans un dépôt GitHub.

La page App Sources de SideStore indique que SideStore « est entièrement compatible avec les sources AltStore (ou AltSources) » et renvoie vers la documentation d’AltStore pour le format. Un seul fichier source couvre donc les deux stores, à condition de le créer pour AltStore Classic (voir la remarque sur PAL ci-dessous).

Il ne s’agit pas d’un fichier sources.list. Ce format est destiné aux gestionnaires de paquets de jailbreak comme Cydia et Sileo, et ne fonctionne ni avec AltStore ni avec SideStore.

Le fichier source minimal

Dans la documentation d’AltStore, les clés de niveau source non marquées comme facultatives sont name, nsfw, apps et news. Voici une structure minimale fonctionnelle pour une seule application, construite à partir des exemples de la documentation d’AltStore :

{
  "name": "My Example Source",
  "subtitle": "A source for all of my apps",
  "iconURL": "https://example.com/source_icon.png",
  "website": "https://example.com",
  "nsfw": false,
  "apps": [
    {
      "name": "My Example App",
      "bundleIdentifier": "com.example.myapp",
      "developerName": "Example Developer",
      "localizedDescription": "What the app does.",
      "iconURL": "https://example.com/myapp_icon.png",
      "versions": [
        {
          "version": "1.0",
          "buildVersion": "1",
          "date": "2026-10-28",
          "downloadURL": "https://example.com/myapp-1.0.ipa",
          "size": 79821,
          "minOSVersion": "14.0"
        }
      ],
      "appPermissions": {
        "entitlements": [],
        "privacy": {}
      }
    }
  ],
  "news": []
}

Les clés les plus importantes

Clé Ce que dit la documentation d’AltStore à ce sujet
bundleIdentifier Doit correspondre exactement à CFBundleIdentifier dans le Info.plist de l’application, et est sensible à la casse. Une source ne peut pas répertorier deux applications avec le même identifiant.
version et buildVersion Doivent correspondre à CFBundleShortVersionString et CFBundleVersion dans le Info.plist.
downloadURL Pour AltStore Classic, l’URL du fichier .ipa téléversé.
size La taille de l’application en octets, affichée aux utilisateurs sur la page du store.
date La date de sortie au format ISO 8601, par exemple 2026-10-28.
minOSVersion / maxOSVersion Facultatif. AltStore masque les mises à jour que l’appareil ne peut pas exécuter. La documentation précise que la plupart des applications ne devraient pas définir de maximum.
appPermissions Chaque entitlement et chaque clé de confidentialité « UsageDescription » présente dans l’application. AltStore les compare avec l’IPA téléchargé.
marketplaceID Uniquement pour les applications AltStore PAL notariées. Non requis pour AltStore Classic.
category Facultatif. L’une des valeurs suivantes : developer, entertainment, games, lifestyle, other, photo-video, social ou utilities.

Pour lire les valeurs du Info.plist d’un IPA que vous avez compilé, renommez une copie en .zip, ouvrez Payload/YourApp.app/Info.plist, et copiez les trois valeurs ci-dessus. Si vous avez encore besoin de l’IPA lui-même, consultez comment créer votre propre fichier IPA.

Étape par étape

  1. Compilez votre application et exportez le fichier .ipa.
  2. Téléversez le .ipa sur un hébergeur que vous contrôlez et copiez son URL de téléchargement direct.
  3. Rédigez le fichier JSON, ou téléchargez l’exemple de source d’AltStore pour AltStore Classic depuis la page Make a Source et modifiez-le.
  4. Renseignez les valeurs du Info.plist, la taille en octets et la liste complète des permissions.
  5. Téléversez le fichier JSON et ouvrez son URL dans un navigateur pour vérifier qu’il se charge comme du JSON brut.
  6. Ajoutez l’URL dans AltStore ou SideStore et testez une installation sur un appareil réel avant de partager le lien.

Des outils qui s’en chargent pour vous

  • altsource (AltServer pour macOS). La documentation d’AltStore indique qu’AltServer pour macOS inclut un outil en ligne de commande bêta à AltServer.app/Contents/MacOS/altsource. altsource new --ipa crée une source à partir d’un IPA, et altsource update ajoute une application ou une nouvelle version.
  • AltPublisher. La documentation d’AltStore le mentionne comme un « outil créé par la communauté » pour générer une source.
  • AltStudio et AltSource Browser. La documentation de SideStore liste ces outils communautaires. Elle prévient qu’une fois qu’AltStudio a créé une source, vous devez supprimer ses champs marketplaceID et Build générés automatiquement, « sinon SideStore pensera qu’il s’agit d’une source notariée et empêchera son ajout ».

Les outils communautaires ne sont pas créés par AltStore ou SideStore. Vérifiez le JSON qu’ils produisent avant de le publier.

Publier des mises à jour

Pour diffuser une nouvelle version, téléversez le nouvel IPA et ajoutez une nouvelle entrée au début de la liste versions de l’application. La page d’AltStore sur la mise à jour des applications indique qu’elle compare la première entrée à la version installée et « n’utilise pas les dates pour déterminer s’il existe une version plus récente ». Chaque entrée doit avoir un version ou un buildVersion différent. Les utilisateurs doivent tout de même installer la mise à jour eux-mêmes, ce que notre guide sur la mise à jour des applications sideloadées explique.

Partager votre source

La documentation de SideStore propose un format de lien en un seul geste : sidestore://source?url= suivi de l’URL de votre source. Elle précise que le lien plante si SideStore n’est pas installé, donc pensez aussi à fournir l’URL brute à coller dans l’onglet Sources.

Une remarque sur AltStore PAL

AltStore PAL, la version destinée à l’UE, utilise des applications notariées au format ADP d’Apple, et nécessite un marketplaceID ainsi qu’une URL de manifeste au lieu d’un simple lien IPA. Cela nécessite un compte développeur Apple enregistré et la notarisation d’Apple, ce qui est une tâche différente de celle d’une source de sideloading. SideStore n’ajoutera pas de source notariée. Si vous partagez des fichiers IPA, construisez pour AltStore Classic.

FAQ

Puis-je héberger une source sur GitHub ?

Oui. Une source est un fichier JSON statique. GitHub Pages et les fichiers bruts d’un dépôt permettent tous deux de la servir, et plusieurs sources publiques fonctionnent de cette façon.

Pourquoi AltStore refuse-t-il d’installer une application depuis ma source ?

La cause la plus fréquente dans la documentation est un problème de permissions : la liste appPermissions doit inclure chaque entitlement et chaque clé de confidentialité utilisée par l’IPA. Un bundleIdentifier ou une chaîne de version incorrecte pose également problème.

Pourquoi mes utilisateurs ne voient-ils pas la mise à jour ?

La nouvelle version n’est probablement pas en première position dans la liste versions, elle possède le même numéro de version et de build que l’ancienne, ou son minOSVersion est supérieur à la version iOS de l’utilisateur.

Scarlet peut-il utiliser ma source AltStore ?

Scarlet utilise son propre format de dépôt et signe les applications avec un certificat entreprise partagé, il s’agit donc d’un système distinct. Consultez notre guide bibliothèques et dépôts IPA. Scarlet est confirmé sur iOS 14 à iOS 26 ; la prise en charge d’iOS 27 est signalée par des tiers mais n’est pas officiellement confirmée.

A lire également