◉RORK LABEN
●MCP — Rork で、自前の MCP サーバーを Plugins の中で追加・管理できるようになりました(11/21)●2.5 ROUTE — 12/1 から、アプリに埋め込んだ gemini-2.5-flash は 3.5 Flash-Lite へ自動で回り、料金も変わります(残り9日)●CHANNEL — Expo Go で Android の通知チャネルの読み書きが失敗する、という報告が出ています●NEW — 新着:「起動画面から進みません」に返信する前の3つの手がかり●EXPORT — プランを下げる・解約する前は、先にプロジェクトをエクスポートしておくと安心です●SONNET 4.5 — API 連携で Sonnet 4.5 を使っているアプリは、11/30 の提供終了前に移行先へ切り替えておきましょう●MCP — Rork で、自前の MCP サーバーを Plugins の中で追加・管理できるようになりました(11/21)●2.5 ROUTE — 12/1 から、アプリに埋め込んだ gemini-2.5-flash は 3.5 Flash-Lite へ自動で回り、料金も変わります(残り9日)●CHANNEL — Expo Go で Android の通知チャネルの読み書きが失敗する、という報告が出ています●NEW — 新着:「起動画面から進みません」に返信する前の3つの手がかり●EXPORT — プランを下げる・解約する前は、先にプロジェクトをエクスポートしておくと安心です●SONNET 4.5 — API 連携で Sonnet 4.5 を使っているアプリは、11/30 の提供終了前に移行先へ切り替えておきましょう
記事一覧/ビジネス
⟐ ビジネス/2026-11-17中級

iOS 27 で年齢確認が失敗したとき、エラーを「待つ・情報なしで進む・直す」の三つに分けておく

iOS 27 で Apple が年齢確認 API に足した3つのエラー(オンボーディング未完了・アカウント不適合・通信)は、expo-age-range ではまだコードなしで JS に届きます。メッセージ文字列に頼らずに、再試行・年齢情報なし・実装ミスの三つへ振り分ける最初の実装と、画面に出す文言の決め方をまとめます。

expo-age-rangeDeclared Age RangeiOS 275年齢確認App Store 審査3個人開発236Rork620

iOS 27 の変更点を一つずつ読み返していた夜、年齢確認の API に見慣れないエラーが三つ増えていることに気づきました。declinedOnboarding、invalidAccount、そして network。名前だけ見れば意味は分かりそうですが、私のアプリのコードは、この三つを受け取ったときに何をするのかを一行も決めていませんでした。

調べていくと、11 月 16 日に Expo の Issue(#53549)として、ちょうどこの件が報告されていました。expo-age-range は iOS 27 で増えた三つのケースに専用のエラーコードを付けておらず、JS 側からは区別できない、という内容です。Issue は報告とほぼ同時にクローズされていますが、11 月 17 日の時点で main のソースを読む限り、三つの対応はまだ入っていません。

最初にお伝えしたいのは、コードが付くのを待つ必要はない、という点です。エラーの「行き先」を先に三つ決めておけば、いまの版のままでも審査に出せるかたちにできます。

いま JS に届くエラーの顔ぶれ

expo-age-range の iOS 側(AgeRangeModule.swift と AgeRangeExceptions.swift)を読むと、requestAgeRangeAsync から JS に届くものは次のように整理できます。iOS 26 より前の OS では確認の画面を出さず、lowerBound: 18(大人と同じ扱い)で返ってくる点も、あわせて覚えておくと迷いません。

JS に届くものcode意味
利用者が共有を断ったERR_AGE_RANGE_USER_DECLINED確認の画面で「共有しない」を選んだ
サービスが使えないERR_AGE_RANGE_NOT_AVAILABLE端末やシミュレータで iCloud にサインインしていない、など
依頼の形が不正ERR_AGE_RANGE_INVALID_REQUEST渡した年齢の境界どうしが 2 歳以上離れていない、など
iOS 27 で増えた3種なしオンボーディング未完了・アカウント不適合・通信の失敗
画面を出せなかった/未知の応答なし表示中の画面が取れない、OS が知らない形で返した

Issue の報告者は、三つの意味を二つに分けて説明しています。network は一時的な失敗なので、少し待ってもう一度試します。declinedOnboarding と invalidAccount は、そのアカウントからは年齢の情報が得られないので、ERR_AGE_RANGE_NOT_AVAILABLE と同じ「情報なしで進む」道へ送ります。この整理には、私も同意しております。

メッセージの文字列で分けようとして、手が止まりました

コードが無いなら、エラーの文言で見分ければよい——最初に書きかけたのは、message に「network」が含まれるかを調べる一行でした。ところが、届く文言は Swift のエラーをそのまま文字にしたもので、Expo が約束している値ではありません。OS の版や端末の言語設定で変わらない保証もありません。

そこで考え方を逆にしました。分かっているコードだけを確実に振り分け、コードの無いものは「一度だけ待って試し、だめなら情報なしで進む」へまとめて送ります。新しい三つのうち network だけは再試行で救える可能性があり、残りの二つは再試行しても結果が変わらないだけなので、一度の再試行で失うものはほとんどありません。

分かるものは名前で分け、分からないものは利用者を止めない側へ倒します。 これが、今回いちばん大事にした線引きです。

三つの行き先に振り分ける最初のコード

次のコードは、年齢確認の結果を「進める」「待って再試行」「年齢情報なし」「実装を直す」に振り分けます。Rork で作ったアプリ(Expo)なら、年齢確認を呼んでいる画面の近くに置くだけで使えます。

import { requestAgeRangeAsync } from 'expo-age-range';
 
type AgeGateResult =
  | { kind: 'ok'; lowerBound: number | null; upperBound: number | null }
  | { kind: 'declined' }      // 利用者が共有を断った
  | { kind: 'noSignal' }      // 年齢情報が得られない(アカウント・サービス側の事情)
  | { kind: 'bug'; code: string }; // 依頼の形が不正。開発者が直す
 
const NO_SIGNAL_CODES = new Set(['ERR_AGE_RANGE_NOT_AVAILABLE']);
 
function codeOf(e: unknown): string | null {
  // ネイティブ由来のエラーは code を持つことがあるが、iOS 27 の3種は持たない
  const c = (e as { code?: unknown } | null)?.code;
  return typeof c === 'string' && c.startsWith('ERR_AGE_RANGE_') ? c : null;
}
 
const wait = (ms: number) => new Promise((r) => setTimeout(r, ms));
 
export async function checkAgeRange(threshold: number): Promise<AgeGateResult> {
  for (let attempt = 0; attempt < 2; attempt++) {
    try {
      const res = await requestAgeRangeAsync({ threshold1: threshold });
      return { kind: 'ok', lowerBound: res.lowerBound, upperBound: res.upperBound };
    } catch (e) {
      const code = codeOf(e);
      if (code === 'ERR_AGE_RANGE_USER_DECLINED') return { kind: 'declined' };
      if (code === 'ERR_AGE_RANGE_INVALID_REQUEST') return { kind: 'bug', code };
      if (code && NO_SIGNAL_CODES.has(code)) return { kind: 'noSignal' };
      // ここに来るのはコードの無いエラー(iOS 27 の network / declinedOnboarding / invalidAccount など)
      if (attempt === 0) {
        await wait(3000); // 通信の失敗なら、3 秒ほど待つと通ることがある
        continue;
      }
      return { kind: 'noSignal' };
    }
  }
  return { kind: 'noSignal' };
}

なぜこう書くのかを、三点だけ補っておきます。

  • message を一度も読まないようにしています。将来 Expo が三つにコードを付けたときは、NO_SIGNAL_CODES に足すか、再試行の対象を名前で絞るだけで済みます。
  • 再試行は 1 回、待ち時間は 3 秒にしています。年齢確認は起動直後や購入の直前に出ることが多く、何度も回すと利用者が画面の前で待たされます。
  • bug は利用者に見せる道ではありません。境界の値を直すべきサインなので、開発中にだけ気づけるよう、ログや自分宛ての通知に流しておくのが安全です。

画面に出す文言を、行き先ごとに一つずつ

行き先が決まると、文言も迷わなくなります。私が下書きに置いたのは、次の三つでした。

  • 待って再試行(2 回目も失敗する前): 「年齢の確認に少し時間がかかっています。もう一度お試しいただけます」
  • 年齢情報なし: 「年齢の情報を確認できなかったため、一部の機能を制限した状態で始めます。設定からいつでも確かめ直せます」
  • 共有を断った: 文言は出さずに、年齢情報なしと同じ扱いで進めます。同じ画面は何度も出しません

ここで「年齢情報なしのときに何を制限するか」は、アプリの中身と、配信する地域に求められる要件で決まります。私自身は、まず「制限した状態で始められる」ことを保証し、制限の中身はあとから詰める順番にしました。アプリが利用者の前で止まってしまうことのほうが、審査でも利用者の評価でも、はるかに痛いからです。

ストアの年齢区分そのものの考え方は、共有ボタンだけなら「ソーシャルメディア機能」には当たりませんで書いた内容とつながっています。

Rork に頼むときは、行き先を先に渡します

Rork のチャットで年齢確認を足してもらうときも、エラーの行き先を先に書いておくと、生成されるコードがぶれにくくなります。私が下書きした依頼文の骨組みは、次のようなかたちです。

年齢確認(expo-age-range の requestAgeRangeAsync)を、設定画面の「年齢を確かめる」から呼んでください。
結果は4つに分けます。
1. 成功: lowerBound を保存し、通常の画面へ
2. ERR_AGE_RANGE_USER_DECLINED: 制限モードで続行。同じ確認は自動で再表示しない
3. ERR_AGE_RANGE_INVALID_REQUEST: 利用者には出さず、console.warn だけ
4. それ以外(code が無いものを含む): 3 秒待って1回だけ再試行し、だめなら制限モードで続行
error.message の文字列では判定しないでください。

最後の一文は、先ほど私が書きかけた「文言で見分ける」道に、生成されるコードが進まないための保険です。依頼の段階で「何で判定しないか」まで書いておくのが、いちばん手戻りが少ないと感じております。

審査に出す前に、手元で確かめる二つのこと

  1. iCloud にサインインしていないシミュレータで呼びます。ERR_AGE_RANGE_NOT_AVAILABLE が返り、「年齢情報なし」の文言と制限モードに進むかを見ます。
  2. 境界の値をわざと 1 歳差にして呼びます(例: threshold1: 16, threshold2: 17)。ERR_AGE_RANGE_INVALID_REQUEST が利用者の画面に出ず、ログだけに残るかを見ます。

正直に書いておくと、iOS 27 で増えた三つのケースを、私の手元の実機でまだ再現できておりません。Issue の報告者も、Apple のドキュメントにもとづく対応で、実機では観測していないと断っています。だからこそ、コードの無いエラーを「止めない側」へまとめて送る書き方にしておく意味があるのだと思います。

公開前の手続き全体は、Rork のアプリを公開する前に、Apple 側で自分が済ませておく手続きにまとめています。審査で指摘を受けた場合の動き方は、App Store でリジェクトされた時の対処辞典が手がかりになるはずです。

まずは、いま年齢確認を呼んでいる箇所の catch を開き、message を読んでいる行が無いかだけを確かめていただければ幸いです。そこが一行でも見つかれば、今日の作業はもう半分済んでいます。

シェア

お読みいただきありがとうございます

Rork Lab は広告なしで運営しており、サーバー費用などの運営コストはメンバーシップのご支援で賄っています。実装コード・ベンチマーク・本番設計パターンなど、実務でお役立ていただける記事を毎日更新しています。もし読んでよかったと感じていただけましたら、ぜひご覧ください。

  • ✦コピー&ペーストで使える実装コード付き
  • ✦毎日新しい上級ガイドを追加
  • ✦¥580/月 または ¥1,480 の永久アクセス
メンバーシップを見る →

もしこの記事がお役に立ちましたら、チップ(¥150)で応援いただけると大変励みになります。広告なしでの運営を続けるため、皆さまのご支援が大きな力になっています。

関連記事

⟐ ビジネス2026-10-28
公開後にアプリ名を変えたくなったら、ストアで続くものと作り直すものを先に分けます。名前を決める前に見るのは商標の検索結果です
App Store Connect で名前が保存できたことと、その名前を使ってよいことは別の話です。公開後に改名する場合に Apple と Google Play の公式記載から言える範囲と、アプリ内に残る旧名を拾う小さなスクリプト、名前を決める前の確認順をまとめました。
⟐ ビジネス2026-10-25
見た目は不透明なのに「アイコンに alpha チャンネルがあります」と弾かれる。PNG の中身を提出前に確かめます
App Store Connect の ITMS-90717(Invalid large app icon)は、透けて見えない画像でも alpha チャンネルが残っているだけで出ます。6種類のサンプル PNG で見分け方を確かめ、標準ライブラリだけの検査スクリプトと、alpha を外す直し方をまとめました。
⟐ ビジネス2026-10-24
Play の延長期限は11月1日——残り8日で、更新の提出日から逆に数えます
target API 36 の延長期限は11月1日です。期限日そのものではなく、審査と段階公開に必要な日数を引いた「提出の最終日」から数える方法を、手元で動く日数計算スクリプトと一緒にまとめました。