AltStore PALでアプリを配信してみる
EUにあるiOS/iPadOSではApp Store以外のアプリストア「代替アプリマーケットプレイス」が利用できるようになっています。日本でもスマホ競争促進法によって今年中には使えるようになりそうです。
面白そうなので触りたい。他に触ってる人を日本で見たこともないし、せっかくなので記事にしようと思います。
(面白いことが書けそうなのでZennに投稿してみます。普段は自分のサイトに書いています。)
最初に知るべきこと
本題に入る前にいくつか知っておくべき事があります。中には金銭に関わるものの含まれるため、試そうと思っている場合は必ず把握しておいた方が良いです。
- AltStore PALが何なのか知らない人は自分で調べてください。
- AltStore PALで配信するには、アプリのパッケージとソース(リポジトリのようなもの)を自分でホストする必要があります。ソースの書き方はあとで説明します。
- EUからでないと直接インストール周りのテストをすることはできません(配信は可能です)。
- App Storeに配信しない場合でも、Apple Developer Programに登録する必要があります。もちろん有料です。
- 代替アプリマーケットプレイスにのみ配信する場合はApp Storeのような厳格な審査はありませんが、Appleによる公証(Notarization)は受ける必要があります。
- 代替アプリマーケットプレイスで配信をするためには「EUにおけるアプリに関する新しい規約の付属文書」に同意する必要があります。この規約にはAppleに支払う手数料に関して重大な変更が含まれており簡単に説明しますが、ご自身の責任のもとで本文も確認してください。
コア技術料(CTF)
これはEU域内におけるアプリのインストール数に応じて課される追加の手数料です。詳しく知りたい場合は付属文書を読むか、サポートページを確認しましょう。
EUに住むユーザーが同じApple Accountで過去1年間でアプリを1回以上インストールした回数を、「年間初回インストール」といいます。これが100万回を超えた場合、それ以降の1インストールごとに€0.50をAppleに支払う必要があります。年間初回インストールの対象になるインストールの種類は以下のページで確認できます。
このCTFがいかに恐ろしいかを説明すると、何かの拍子(SNS等で話題になるなど)でアプリのインストール数が100万を突破し、かつ収益がCTFの支払額に満たない場合は損失になり、最悪の場合は冗談抜きで破産します。
しかし、CTFには免除される条件もあります。
- 年間初回インストールが100万に満たない場合
- 非営利団体、認定教育機関、政府機関などで、Apple Developer Programの免除を受けている場合
- EUに限らず全世界で、アプリを通して一切の収益(有料アプリ、App内課金、サブスク、物販などすべての商業的な収益)を得ない非商業のデベロッパーの場合
- さらに条件を満たす小規模事業者は最大3年間CTFを免除される(ややこしいので詳しくはサポートを読んでください)
私は個人のアプリ開発者として食べているわけでもないし総収益も大したことはないので、すべての有料コンテンツを取り除き、非商業のデベロッパーとして免除を受ける方向で行きました。注意すべきなのは、収益を得ているという判定は全世界でありEUに限らないこと、すでに15から30%の徴収を課されているApp Storeからの収益も含むことです。つまりアプリからの収益は完全に0にする必要があります。もともと法規制が厳しい国や地域では有料コンテンツを配信していなかったため、DSAのあるEUに対しても配信していなかったのですが、その他の国でも停止せざるを得ませんでした。残念ですが、今後の規約の改定に期待。
「EUにおけるアプリに関する新しい規約の付属文書」に同意する
以下のページで規約に同意できます。
ちなみにこれ以降のことは大体AltStore PALのFAQにも書かれています。
AltStore PALを代替アプリマーケットプレイスに追加する
App Store ConnectでデベロッパーIDを確認します。
これをAltStore PALにメールで送信すれば、セキュリティトークンを受け取ることができます。(1日から2日くらいかかりました)
受け取ったセキュリティトークンをApp Store Connectで入力します。この時、代替アプリマーケットプレイスで配信するアプリも選択します(後から変更可能)。
公証(Notarization)を受ける
前述の通り、App Storeに配信しない場合でもAppleによる審査を受ける必要がありますが、ガイドラインはかなり緩和されています。App Storeにも配信している場合はこの手順をスキップできます。
App Storeにアプリを配信しない場合でも、いままでと同じようにApp Store Connectにアプリを追加して詳細情報を入力します。このとき「レビュータイプ」を「認証」にすることで、代替アプリストア専用の審査に切り替えることができます。
審査を通過すると、そのバージョンには「代替配信パッケージID」が付与されます。これはあとで使用します。
代替配信パッケージをAltStore PALに処理してもらう
アプリは各ストア側でも処理してもらう必要があります。AltStoreでのやり方は以下のページにも書いてありますが、一応説明しようと思います。
まずパッケージの処理を手動で開始します。代替アプリマーケットプレイスに追加する際に次回以降の審査後に自動で処理するよう設定できます。
curlが使えるシェルで以下のコマンドを実行します。
curl --header "Content-Type: application/json" \
-X POST \
--data '{ "adpID": "[Your ADP ID]" }' \
https://api.altstore.io/adps
[Your ADP ID]のところに前述の代替配信パッケージIDを入力します。
体感5-10分くらいで処理が完了するので、以下のコマンドでパッケージのダウンロードリンクを取得します。
curl -X GET https://api.altstore.io/adps/[Your ADP ID]
statusがsuccessになっていれば処理が完了しているため、downloadURLをブラウザ等に入力すればパッケージをダウンロードできます。(Macのターミナルからブラウザの検索窓に直接コピペすると%エンコードあたりが悪さをしているのかURLが壊れたので注意)
ダウンロードしたパッケージは別の場所で自分でホストする必要があります。Zipファイルを展開して、ディレクトリの構造を変更せずにそのままWeb上に公開します。HTTPSでダウンロードできる状態にしておいてください。
ソースを作る
AltStore PALの前身、AltStore Classic時代からあるもので、パッケージマネージャーのソース(リポジトリ)と同じような感じです。公式のドキュメントも紹介しておきます。
あと私のソースも参考適度に覗いてみてください: https://i.cizzuk.net/altstore/source.pal.json
ソースを書く前に、AltStore Classicを自身のiPhoneにインストールすることをおすすめします。現状AltStore PALはEUからしかインストールできないため、作ったソースが期待通りのものかテストするにはClassicを使うしかないからです。ただしClassicはiOSのデバッグ機能を裏技っぽく利用していることだけ留意してください。
ソースのメタデータ
ソースは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はヘッダーです。ユーザーの操作がない限りぼかされていてほとんど見ることはありません。設定しない場合はアイコンになります。 -
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です。AltStore ClassicでソースをテストするときはこのIDを削除してください。 -
developerNameは開発者の名前です。OSSでたくさんの人が関わっている時などは「[開発者名] & Various Contributors」と書くことも多いです。 -
localizedDescriptionはアプリの説明です。URLを入れることもできます。 -
categoryはオプションで、以下の中のどれかひとつのカテゴリを設定します。developerentertainmentgameslifestyleotherphoto-videosocialutilities
-
screenshotsはオプションで、例のように簡単に設定することもできますが、iPad向けに別の画像を用意したり横向きの画像を設定することもできます。詳しくは公式のドキュメントを参考にしてください。 -
versionsはこのあと説明します。 -
appPermissionsにはアプリのEntitlementsとプライバシーに関する情報を入力します。以下2つのEntitlementsはすべてのアプリに必ず含まれるものであるため省略できます。そのほかは必須です。com.app.developer.team-identifierapplication-identifier
バージョンを追加
最後にバージョンを追加します。初回リリースとアップデートの管理に利用します。
"versions": [
{
"version": "1.0",
"buildVersion": "60",
"date": "2023-03-30",
"localizedDescription": "First AltStore release!",
"downloadURL": "https://myapp.com/adp",
"size": 79821,
"minOSVersion": "17.4"
}
]
アップデートを配信するたびに、配列に要素を追加します。新しいバージョンは配列の先頭に追加してください。
-
versionとbuildVersionにはInfo.plistに書かれているものと同じバージョンとビルド番号をそれぞれ記載します。基本的に両方がユーザーに表示されますが、marketingVersionを設定すると好きな文字列に表示上は変更できます。 -
dateはバージョンを公開した日付をISO 8601フォーマットで記述します。 -
downloadURLは代替配信パッケージへのURLを入力します。 -
sizeはアプリのサイズです。ユーザーの環境によってサイズが異なってしまうため正確にはなりません。Xcodeから出力したipaファイルのサイズとかApp Storeに記載されているサイズとかで良いと思います。単位は1バイトです。 -
minOSVersionはオプションで、iOS/iPadOSの最小要件です。AltStoreは非対応バージョンを非表示にするので設定すべきです。 -
maxOSVersionもオプションで追加できます。iOS/iPadOSの上限です。Classic時代の名残で、ほとんどのアプリには必要ないはずです。
これでソースは完成したので、Web上にホストしてHTTPSでダウンロードできるようにします。
先述の通り、marketplaceIDを消してあげればAltStore Classicからでもインストール以外は確認できるようになるので、一度試しておきましょう。
完成したソースをAltStore PALに承認してもらう
先にセキュリティトークンを受け取ったAltStore PALからのメールに返信してソースのURLを送ります。(これも1日から2日くらいかかりました)
承認されたと返事が来たら、ソースがAltStore PALで利用可能になります。利用者にソースのURLを公開すればアプリをダウンロードできるようになります。
おまけ: AltStore PALのURLスキーム
ソースのURLをそのまま公開すると、ユーザー視点ではいきなりJSONファイルを見せられて意味不明な状態になります。以下は私のソースです。
https://i.cizzuk.net/altstore/source.pal.json
セキュリティ的に若干微妙ではありますが、AltStore PALを自動で開くURLスキームがあるので紹介しておきます。
スキームはaltstore-pal://で、パスはsource、クエリのurlにソースのURLを入れてあげれば完成です。以下のような感じになります。
altstore-pal://source?url=https://i.cizzuk.net/altstore/source.pal.json
Discussion