AltStore PALでアプリを配信してみる

2025年 3月 26日更新: 2025年 12月 31日

これはZennで公開した記事のミラーです。現物はこちら

EUにあるiOS/iPadOSではApp Store以外のアプリストア「代替アプリマーケットプレイス」が利用できるようになっています。日本でもスマホ競争促進法によって2025年内には使えるようになる~~予定です~~。

追記: 2025年12月18日に法律が施行されたため、正式に日本でも配信が可能になりました。Developerサポートページからスマホ新法に関わる新たな変更を確認できます。

面白そうなので触りたい。他に触ってる人を日本で見たこともないし、せっかくなのでAltStore PALに配信するまでの過程を記事にしようと思います。

最初に知るべきこと

本題に入る前にいくつか確認しておきましょう。

AltStore PALが何なのか知らない人は調べてください。
AltStore PALで配信するには、アプリのパッケージとソース(リポジトリのようなもの)を自分でホストする必要があります。ソースの書き方はあとで説明します。
代替アプリマーケットプレイスが利用可能な地域からでないと、インストール周りのテストをすることはできませんが、配信は可能です。
App Storeに配信しない場合でも、Apple Developer Programに登録する必要があります。もちろん有料です。
代替アプリマーケットプレイスにのみ配信する場合でも公証(Notarization)というAppleによる審査を受ける必要があります。
AltStore PALのガイドラインにも準拠する必要があります。
EUで配信をするためには「EUにおけるアプリに関する新しい規約の付属文書」に同意する必要があります。日本のみでの配信の場合は同意の必要はありません。
App Store経由でないApp内課金等の収益に対しても、手数料をAppleに支払う必要があります。また、トランザクションをAppleに報告する義務が発生します。

AltStore PALを代替アプリマーケットプレイスに追加する

REST APIを利用してデベロッパーIDとメールアドレスを送信します。

ADP REST API | AltStore

App Store ConnectのユーザーとアクセスでデベロッパーIDを確認してから、以下のAPIを叩きます。[Your Apple Developer ID]と[Your Email Address]は書き換えてください。

curl --header "Content-Type: application/json" \
  -X POST \
  --data '{ 
    "developerID": "[Your Apple Developer ID]", 
    "email": "[Your Email Address]"
  }' \
  https://api.altstore.io/register

セキュリティトークンが返ってくるので、それをApp Store Connectのマーケットプレイスで入力します。この時、AltStore PALで配信するアプリも選択します(後から変更可能)。

代替アプリマーケットプレイスでの配信の管理 - App Store Connect - ヘルプ - Apple Developer

代替アプリマーケットプレイスへの通知を有効にすると、アプリが審査を通過した際に、各ストア側の処理を自動で開始させることができます。この「ストア側の処理」についてもあとで説明しますが、とりあえず有効にしておいて良いと思います。

公証(Notarization)を受ける

代替アプリマーケットプレイスのみの配信でも、公証というAppleによる審査を受ける必要があります。App Storeにも配信している場合はこの手順をスキップできます。

認証に向けた審査申請 - App Store Connect - ヘルプ - Apple Developer

公証はApp Storeのガイドラインと比べると、特にビジネスを中心に多数の条項が削除されています。ただし有害なアプリは依然としてリジェクトの対象となります。ガイドラインの差分はApp Reviewガイドラインのページから簡単に確認できます。

App Reviewガイドライン - Apple Developer

App Storeにアプリを配信しない場合でも、App Store Connectにアプリを追加して詳細情報を入力する必要があります。この情報はユーザーが設定でオフにしない限りアプリのインストール前に表示されます。また「レビュータイプ」を「認証」にすることで、代替アプリストア専用の審査(公証)に切り替えることができます。

審査で承認されると、そのバージョンに「代替配信パッケージID (ADP ID)」が付与されます(App Store Connectの審査履歴から確認できます)。これはあとで使用します。

代替配信パッケージIDの取得 - App Store Connect - ヘルプ - Apple Developer

代替配信パッケージをAltStore PALに処理してもらう

パッケージはAppleの審査を通過後、各ストア側でインストール可能な状態に処理してもらう必要があります。AltStoreでのやり方は以下のページにも書いてあります。

ADP REST API | AltStore

以下のAPIを叩くと、パッケージの処理を手動で開始できます。[Your ADP ID]のところに前述の代替配信パッケージIDを入力します。代替アプリマーケットプレイスへの通知を有効にした場合、以降は自動で処理が開始されるのでこの手順はスキップできるようになります。

curl --header "Content-Type: application/json" \
  -X POST \
  --data '{ "adpID": "[Your ADP ID]" }' \
  https://api.altstore.io/adps

アプリのサイズにもよるかもしれませんが概ね3-5分くらいで処理が完了するので、以下のAPIでパッケージのダウンロードリンクを取得します。

curl -X GET https://api.altstore.io/adps/[Your ADP ID]

statusがsuccessになっていれば処理が完了しているため、downloadURLをブラウザ等に入力すればパッケージの入ったZipファイルをダウンロードできます。(Macのターミナルからブラウザの検索窓に直接コピペすると、エスケープのせいで正しくアクセスできないので注意(1敗))

ダウンロードしたパッケージは自分でホストする必要があります。ダウンロードしたZipファイルを展開して、ディレクトリの構造を変更せずにそのままWeb上に公開します。HTTPSでダウンロードできる状態にしておく必要があります。

ソースを作る

AltStore PALの前身、AltStore Classic時代からあるもので、パッケージマネージャーのソース(リポジトリ)と同じような感じです。

Make a Source | AltStore

私のソースも参考適度に覗いてみてください: https://i.cizzuk.net/altstore/source.pal.json

また、ソース内のアプリはPatreonと連携させて、パトロンだけがインストールできるようにすることができます。CTFの財源を確保したい場合に便利な機能だと思います。この記事では紹介しないので、公式のドキュメントを参考に設定してください。

ソースのメタデータ

ソースはJSON形式です。以下はサンプルです。

{
  "name": "My Example Source",
  "subtitle": "A source for all of my apps",
  "description": "Welcome to my source! Here you'll find all of my apps.",
  "iconURL": "https://example.com/source_icon.png",
  "headerURL": "https://example.com/source_header.png",
  "website": "https://example.com",
  "tintColor": "#F54F32",
  "featuredApps": [
    "com.example.myapp",
    "com.example.anotherapp"
  ],
  "apps": [],
  "news": []
}

nameとapps以外はすべてオプションです。

name: ソースの名前を入れます。
subtitle: サブタイトルで、名前の下に表示されます。
description: ソースの説明文で、ソースの最下部に表示されます。URLを入れることもできます。
iconURL: ソースのアイコンです。視認性のために設定することをおすすめします。設定しない場合は最初のアプリがアイコンになります。
headerURL: ヘッダーです。UIの設計上ほとんど見えません。設定しない場合はアイコンになります。
website: サブタイトルの下に表示されるリンクです。
tintColor: ソースのテーマカラーで16進数のカラーコードを入力します。文字などにも使用されるので見やすい色にしましょう。
featuredApps: おすすめのアプリを最大5つ設定できます。ソースの目立つところに表示されます。
apps: このあと説明します。
news: この記事では割愛します。

アプリを追加

appsの中は以下のような感じで、配信しているアプリの配列になります。

"apps": [
    {
        "name": "My Example App",
        "bundleIdentifier": "com.example.myapp",
        "marketplaceID": "12345678",
        "developerName": "Example Developer",
        "subtitle": "An awesome app.",
        "localizedDescription": "This is an awesome app only available on AltStore.",
        "iconURL": "https://example.com/myapp_icon.png",
        "tintColor": "#F54F32",
        "category": "utilities",
        "screenshots": [
            "https://example.com/myapp_screenshot1.png",
            "https://example.com/myapp_screenshot2.png",
            "https://example.com/myapp_screenshot3.png"
        ],
        "versions": [],
        "appPermissions": {
            "entitlements": [
                "com.apple.security.application-groups",
                "com.apple.developer.siri"
            ],
            "privacy": {
                "NSMicrophoneUsageDescription": "App uses the microphone to record audio.",
                "NSCameraUsageDescription": "App uses the camera to take photos."
            }
        }
    }
]

ソースのメタデータとかぶっているものは省略します。

bundleIdentifier: アプリのBundleIDです。Info.plistのCFBundleIdentifierとかXcodeのプロジェクトの設定で確認できます。
marketplaceID: App Store Connectの「App情報」から確認できるApple IDです。
developerName: 開発者の名前です。OSSでたくさんの人が関わっている時などは「[開発者名] & Various Contributors」と書くことが多いです。
localizedDescription: アプリの説明です。URLを入れることもできます。
category: オプションで、以下の中のどれかひとつのカテゴリを設定します。
- developer
- entertainment
- games
- lifestyle
- other
- photo-video
- social
- utilities
screenshots: オプションで、例のように簡単に設定することもできますが、iPad向けに別の画像を用意したり横向きの画像を設定することもできます。詳しくは公式のドキュメントを参考にしてください。
versions: このあと説明します。
appPermissions: アプリのEntitlementsとプライバシーに関する情報を入力します。以下2つのEntitlementsはすべてのアプリに必ず含まれるものであるため省略できます。そのほかは必須です。EntitlementsはApp Store Connectでビルドのメタデータから確認することができます。
- com.app.developer.team-identifier
- application-identifier

バージョンを追加

最後にバージョンを追加します。初回リリースとアップデートの管理に利用します。

"versions": [
  {
    "version": "1.0",
    "buildVersion": "60",
    "date": "2023-03-30",
    "localizedDescription": "First AltStore release!",
    "downloadURL": "https://example.com/adp/b3177aba-0596-461c-8460-fbfffca3d270/",
    "size": 79821,
    "minOSVersion": "17.4"
  }
]

アップデートを配信するたびに、配列に要素を追加します。新しいバージョンは配列の先頭に追加してください。

versionとbuildVersion: Info.plistに書かれているものと同じバージョンとビルド番号をそれぞれ記載します。基本的に両方がユーザーに表示されますが、marketingVersionを設定すると別の文字列に差し替えることができます。
date: バージョンを公開した日付をISO 8601フォーマットで記述します。
downloadURL: 自身でホストしている代替配信パッケージへのURLを入力します。
size: アプリのサイズで単位は1バイトです。ユーザーの環境によってサイズが異なってしまうため正確でなくてもOKです。App Store Connectでビルドのメタデータから確認することができます。
minOSVersion: オプションで、iOS/iPadOSの最小要件です。AltStoreは非対応バージョンを非表示にするので設定すべきです。

これでソースが完成したので、Web上にホストしてHTTPSでダウンロードできるようにします。

最後にユーザーにソースを公開する

完成したソースのURLをユーザーに公開すれば、ユーザーがアプリをダウンロードできるようになります。

ソースを登録してもらう方法には、AltStore PALアプリ内のSourcesタブからURLを入力してもらうか、次の「おまけ」に書いてあるURLスキームを使う方法があります。

以上です。お疲れ様でした。

おまけ: AltStore PALのURLスキーム

ソースのURLをそのまま公開すると、ユーザー視点ではいきなりJSONファイルを見せられて意味不明な状態になります。

AltStore PALを自動で開くURLスキームがあるので紹介しておきます。

スキームはaltstore-pal://で、パスはsource、クエリのurlにソースのURLを入れてあげれば完成です。以下のような感じになります。

altstore-pal://source?url=https://i.cizzuk.net/altstore/source.pal.json

おまけ2: アプリの説明の翻訳

公式のドキュメントには書いてませんが、AltStoreの公式ソースで利用されていたものを紹介します。

subtitleやlocalizedDescriptionといった特定のキーに対応して、翻訳を設定できるキーが存在しています。以下は見つかったキーのリストです。

翻訳対象になるテキストのキー	翻訳内容のキー
`subtitle`	`localizedSubtitles`
`description`	`localizedDescriptions`
`localizedDescription`	`localizedDescriptions`

これらのキーはソース内で以下のように、言語コードをキーとしたオブジェクトとして使用します。ソース自体の説明のほか、アプリやニュースでも利用できます。

"apps": [
    {
        "name": "Customize Search Engine",
        "subtitle": "Customize your Safari's Search Engine",
        "localizedSubtitles": {
            "en": "Customize your Safari's Search Engine",
            "ja": "Safariの検索エンジンをカスタマイズ"
        },
        "localizedDescription": "Safari Extension to customize your search engine.",
        "localizedDescriptions": {
            "en": "Safari Extension to customize your search engine.",
            "ja": "Safariの検索エンジンをカスタマイズするための拡張機能です。"
        },
        ...
    }
]

おまけ3: AltStore公式Mastodonにソースを登録する

explore.alt.storeという、AltStoreが運営しているMastodonインスタンスがあります。

このインスタンスで、自分のソース内のアプリのアップデートやニュースを配信してくれるBotを作成することができます。ただし、自分で直接ログインをしたり投稿をすることはできません。あくまでAltStoreの管轄で自動管理されるものになります。

先にソースに変更を加えます。ソースにfediUsernameというキーを追加します。

{
  "name": "My Example Source",
  "fediUsername": "example",

  ...
}

これはexplore.alt.store上でのユーザー名になります。例えばexampleなら@example@alt.storeといった具合です。ActivityPubの仕様上、これは後から変更できません。

ソースを更新したら、以下のAPIを叩きます。[YOUR SOURCE URL]のところにソースのURLを入れます。

curl --header "Content-Type: application/json" \
  -X POST \
  --data '{  
    "source": "[YOUR SOURCE URL]"
  }' \
  https://api.altstore.io/federate

しばらくするとアカウントが作成され、今までのアップデート履歴やニュースも含めて投稿され始めます。