Apple Style Guideを読む

Apple Style Guide を読む 宇佐見公輔 2025-07-04 / Mobile Act OSAKA 16

自己紹介 宇佐見公輔（うさみこうすけ） • ゆめみ iOS テックリード 近況 • 7/5（土）大阪ライブ出演 • 7/20（日）東京ライブ出演 • ブレーミア結成 40 年 • https://chor-vremya.com/ 1 / 29

• https://chor-vremya.com/

本の紹介 Swift Testing 本 • 技術書典 18 で新刊を出しました • 電子版を引き続き頒布中 2 / 29

• https://techbookfest.org/product/kNeYDqeMsjmejthYsZY4nR

iOSDC Japan 2025 今年もプロポーザル出しました。 • パンフ記事は採択、執筆中 • トーク（2 本）は結果待ち ⭐ スターください 3 / 29

Apple Style Guide と は

Apple Style Guide https://support.apple.com/guide/applestyleguide Apple Style Guide とは 5 / 29

• https://support.apple.com/guide/applestyleguide

Apple のガイドライン Human Interface Guidelines • Apple 製品向けアプリのデザインのガイドライン • iOS アプリ開発者にとって必読 Apple Style Guide • Apple 製品に関する用語や表現のガイドライン • UI やドキュメントの正しい表記や表現を知る • これも開発者は知っておきたい Apple Style Guide とは 6 / 29

配布形態 英語のみで、日本語版はない。 Web 版 • Apple のサイトにある • ただ、トップからたどり着くのが難しい • Web 検索したほうが早くたどり着ける PDF 版 • Web 版のトップに PDF 版も置いてある • 最新版（June 2025）は 243 ページ Apple Style Guide とは 7 / 29

Apple Style Guide の 内容

目次 • Style and usage（用語集、212 ページ） • Writing inclusively（インクルーシブな記述、7 ページ） • Units of measure（数量や単位の表記、7 ページ） • Technical notation（コードなどの技術的な表現、2 ページ） • International style（国際的スタイルでの表記、5 ページ） （目次から抜粋。ページ数は PDF 版より） Apple Style Guide の内容 9 / 29

読み方 用語集は、数字、A、B、C、…と並んでいて、辞書的に使う構成に なっている。 用語集が内容のほとんどなので、国語辞書＋付録のようなイメージ。 普通のガイドラインのように、各セクションを順に読むという形式で はない。 辞書を「読む」＝気になる用語を開いて、そこから派生語を見たり前 後を見たりする。 Apple Style Guide の内容 10 / 29

用語紹介 ここから、いくつか用語をピックアップして紹介していく。 Apple Style Guide の内容 11 / 29

Apple Account

「Apple ID」ではない ⭕ Apple Account • ❌ Apple ID • 補足 • 昨年、Apple ID から Apple Account に名称変更された Apple Account 13 / 29

サインインの表現 ⭕ Sign in to your Apple Account • ❌ Sign in with your Apple Account • 補足 • Apple Account「に」サインインする • Apple Account「で」（デバイスやサービスに）サインインする のではない • アカウントという概念をどう捉えるかの参考になる Apple Account 14 / 29

関連：Sign in with Apple • ⭕ Sign in with Apple • 大文字小文字に注意 ユーザーが App や Web サイトに、Apple Account を使って安全に サインインする機能。 補足 • これは機能の名称なので正確に。 Apple Account 15 / 29

サインイン時の入力 ⭕ メールアドレスを入力し、パスワードを入力する • ❌ Apple Account を入力し、パスワードを入力する • 補足 •「Apple Account」という言葉でメールアドレスを意味すること にはならない Apple Account 16 / 29

crash

クラッシュとは言わない ⭕ 予期せず終了する • ⭕ 応答しない • ⭕ 応答を停止する • ❌ クラッシュする • 補足 • クラッシュという言葉は、ハードウェアやソフトウェアの損傷を連 想させ、ユーザーに誤解を招く crash 18 / 29

関連：Crash Detection • ⭕ Crash Detection • 大文字小文字に注意 事故に遭ったときに iPhone や Apple Watch の衝突事故検出で助 けを呼ぶ - Apple サポート (日本) 補足 • Crash という言葉は、実際に衝突事故の意味で使われている • 日本語では「衝突事故検出」という名称が使われている crash 19 / 29

• https://support.apple.com/ja-jp/104959

error message

ユーザー向けにはエラーとは言わない ❌ エラーメッセージ • ⭕ メッセージ • ⭕ アラート、アラートメッセージ • ⭕ 開発者向け資料で「エラーメッセージ」という語を使う • 補足 • エラーという言葉は開発者向け error message 21 / 29

push notification

ユーザー向けには使わない ❌ プッシュ通知 • ⭕ 通知 • ⭕ 開発者向け資料で「プッシュ通知」という語を使う • 補足 • プッシュ通知という言葉は開発者向け push notification 23 / 29

abbreviations and acronyms

略語と頭字語 acronyms（アクロニム、頭字語） • 複合語の頭文字や主要部から形成される単語 • 単語として発音される • ROM : read-only memory abbreviations（略語） • 同様の方法で形成される単語 • 単語として発音されない • MB/s : megabytes per second abbreviations and acronyms 25 / 29

略語と頭字語のガイドライン この項目は、略語や頭字語についてのガイドラインでもある。 spell out（略さずに書く） • 略語や頭字語になじみがない場合 ‣ internet service provider (ISP) • 略語や頭字語になじみがある場合 ‣ URL (Uniform Resource Locator) • spell out 不要な単語 ‣ JPEG abbreviations and acronyms 26 / 29

略語と頭字語の発音 pronunciation という項目に記載がある。 • 発音が自明でないときは発音キーを提供する ‣ WYSIWYG (pronounced “WIZ-zee-wig”) • 発音キーはこのスタイルガイドに記載している ‣ URL (pronounced “you-are-ell”) ‣ JPEG (pronounced “JAY-peg”) • 記載されていない場合には、独自の発音キーを書かない abbreviations and acronyms 27 / 29

まとめ

Apple Style Guide を読もう • Apple Style Guide も開発者は知っておきたい • 辞書のような存在 •「読む」＝気になる用語を開いて、そこから前後を見る • 最初のとっかかりとして、今回紹介したものを見ると良いかも まとめ 29 / 29