TestFlight の外部テストと段階公開、個人開発ではどちらに時間を使うか

// check-build-state.mjs
// 使い方: node check-build-state.mjs <APP_ID>
// 事前準備: App Store Connect の「ユーザーとアクセス > 統合」で API キーを作り、
//           .p8 を安全な場所に置いて環境変数からパスを渡します。
import { readFileSync } from "node:fs";
import jwt from "jsonwebtoken";
 
const KEY_ID = process.env.ASC_KEY_ID;        // 例: YOUR_KEY_ID
const ISSUER_ID = process.env.ASC_ISSUER_ID;  // 例: YOUR_ISSUER_ID
const KEY_PATH = process.env.ASC_KEY_PATH;    // 例: /secure/AuthKey_YOUR_KEY_ID.p8
const APP_ID = process.argv[2];
 
if (!KEY_ID || !ISSUER_ID || !KEY_PATH || !APP_ID) {
  console.error("環境変数 ASC_KEY_ID / ASC_ISSUER_ID / ASC_KEY_PATH と APP_ID が必要です");
  process.exit(2);
}
 
// トークンの有効期間は 20 分以内に収めます。これを超えると 401 が返ります。
function makeToken() {
  const privateKey = readFileSync(KEY_PATH, "utf8");
  return jwt.sign({}, privateKey, {
    algorithm: "ES256",
    expiresIn: "15m",
    issuer: ISSUER_ID,
    audience: "appstoreconnect-v1",
    header: { alg: "ES256", kid: KEY_ID, typ: "JWT" },
  });
}
 
async function api(path, token) {
  const res = await fetch(`https://api.appstoreconnect.apple.com${path}`, {
    headers: { Authorization: `Bearer ${token}` },
  });
  if (res.status === 401) throw new Error("認証に失敗しました。KEY_ID と .p8 の対応を確認してください");
  if (res.status === 429) throw new Error("レート制限に達しました。実行間隔を空けてください");
  if (!res.ok) throw new Error(`${path} が ${res.status} を返しました`);
  return res.json();
}
 
// 直近 5 件のビルドについて、処理状態・外部配布可否・審査状態をまとめて出します。
async function main() {
  const token = makeToken();
  const query = [
    `filter[app]=${APP_ID}`,
    "sort=-uploadedDate",
    "limit=5",
    "include=buildBetaDetail,preReleaseVersion",
    "fields[builds]=version,processingState,expired,buildBetaDetail,preReleaseVersion",
    "fields[buildBetaDetails]=externalBuildState,internalBuildState",
    "fields[preReleaseVersions]=version",
  ].join("&");
 
  const body = await api(`/v1/builds?${query}`, token);
  const included = new Map((body.included ?? []).map((x) => [`${x.type}:${x.id}`, x]));
 
  for (const build of body.data) {
    const detailRef = build.relationships?.buildBetaDetail?.data;
    const versionRef = build.relationships?.preReleaseVersion?.data;
    const detail = detailRef ? included.get(`buildBetaDetails:${detailRef.id}`) : null;
    const version = versionRef ? included.get(`preReleaseVersions:${versionRef.id}`) : null;
 
    const marketing = version?.attributes?.version ?? "?";
    const buildNo = build.attributes.version;
    const processing = build.attributes.processingState;      // PROCESSING / VALID / FAILED / INVALID
    const external = detail?.attributes?.externalBuildState;  // READY_FOR_BETA_SUBMISSION など
    const expired = build.attributes.expired ? " [期限切れ]" : "";
 
    console.log(`${marketing} (${buildNo}) 処理=${processing} 外部=${external ?? "-"}${expired}`);
  }
}
 
main().catch((err) => {
  console.error(`確認できませんでした: ${err.message}`);
  process.exit(1);
});

#!/usr/bin/env bash
set -euo pipefail
for APP_ID in 1111111111 2222222222 3333333333; do
  echo "--- ${APP_ID} ---"
  node check-build-state.mjs "${APP_ID}" || echo "  (取得できませんでした)"
done