iOS アプリケーション開発ガイド

UIKit、SnapKit、SwiftUI を使用して iOS アプリケーションを構築するための実践的なガイドです。Apple プラットフォームの実証済みのパターンと規約に焦点を当てています。

クイックリファレンス

UIKit

目的	コンポーネント
メインセクション	UITabBarController
ドリルダウン	UINavigationController
フォーカスされたタスク	Sheet プレゼンテーション
重大な選択	UIAlertController
セカンダリアクション	UIContextMenuInteraction
リストコンテンツ	UICollectionView + DiffableDataSource
セクション付きリスト	DiffableDataSource + headerMode
グリッドレイアウト	UICollectionViewCompositionalLayout
検索	UISearchController
共有	UIActivityViewController
位置情報（1回限り）	CLLocationButton
フィードバック	UIImpactFeedbackGenerator
リニアレイアウト	UIStackView
カスタム図形	CAShapeLayer + UIBezierPath
グラデーション	CAGradientLayer
モダンボタン	UIButton.Configuration
動的テキスト	UIFontMetrics + preferredFont
ダークモード	セマンティックカラー（.systemBackground、.label）
許可	コンテキスト内リクエスト + AVCaptureDevice
ライフサイクル	UIApplication 通知

SwiftUI

目的	コンポーネント
メインセクション	TabView + tabItem
ドリルダウン	NavigationStack + NavigationPath
フォーカスされたタスク	.sheet + presentationDetents
重大な選択	.alert
セカンダリアクション	.contextMenu
リストコンテンツ	List + .insetGrouped
検索	.searchable
共有	ShareLink
位置情報（1回限り）	LocationButton
フィードバック	UIImpactFeedbackGenerator
進捗（既知）	ProgressView(value:total:)
進捗（未知）	ProgressView()
動的テキスト	.font(.body) セマンティックスタイル
ダークモード	.primary、.secondary、Color(.systemBackground)
シーンライフサイクル	@Environment(\.scenePhase)
モーション削減	@Environment(\.accessibilityReduceMotion)
ダイナミックタイプ	@Environment(\.dynamicTypeSize)

コア原則

レイアウト

• タッチターゲット >= 44pt
• セーフエリア内のコンテンツ（SwiftUI はデフォルトで尊重、背景にのみ .ignoresSafeArea() を使用）
• 8pt スペーシング単位を使用（8、16、24、32、40、48）
• プライマリアクションをサムゾーンに配置
• すべての画面サイズに対応（iPhone SE 375pt から Pro Max 430pt）

タイポグラフィ

• UIKit: preferredFont(forTextStyle:) + adjustsFontForContentSizeCategory = true
• SwiftUI: セマンティックテキストスタイル .headline、.body、.caption
• カスタムフォント: UIFontMetrics / Font.custom(_:size:relativeTo:)
• アクセシビリティサイズで レイアウトを適応させる（最小 11pt）

カラー

• セマンティックシステムカラーを使用（.systemBackground、.label、.primary、.secondary）
• カスタムカラー用のアセットカタログバリアント（Any/Dark Appearance）
• 色のみの情報は使用しない（アイコンまたはテキストと組み合わせる）
• コントラスト比 >= 4.5:1（通常テキスト）、3:1（大きいテキスト）

アクセシビリティ

• アイコンボタンのラベル（.accessibilityLabel()）
• モーション削減を尊重（@Environment(\.accessibilityReduceMotion)）
• 論理的な読み取り順序（.accessibilitySortPriority()）
• 太字テキスト、コントラスト増加設定をサポート

ナビゲーション

• タブバー（3～5セクション）はナビゲーション中も表示
• 戻るスワイプが機能する（システムジェスチャーは上書きしない）
• タブ間で状態を保持（@SceneStorage、@State）
• ハンバーガーメニューは使用しない

プライバシー & 許可

• コンテキスト内で許可をリクエスト（起動時ではない）
• システムダイアログの前にカスタム説明を用意
• Apple でサインインをサポート
• ATT 拒否を尊重

チェックリスト

レイアウト

• タッチターゲット >= 44pt
• セーフエリア内のコンテンツ
• プライマリアクションをサムゾーン（下半分）に配置
• すべての画面サイズ（SE から Pro Max）に対応する柔軟な幅
• スペーシングが 8pt グリッドに配置

タイポグラフィ

• セマンティックテキストスタイルまたは UIFontMetrics でスケールされたカスタムフォント
• アクセシビリティサイズまで Dynamic Type をサポート
• 大きいサイズでレイアウトが反映される（切り詰めなし）
• 最小テキストサイズ 11pt

カラー

• セマンティックシステムカラーまたはライト/ダークアセットバリアント
• ダークモードは意図的（単なる反転ではない）
• 色のみの情報なし
• テキストコントラスト >= 4.5:1（通常）/ 3:1（大きい）
• インタラクティブ要素に単一のアクセントカラーを使用

アクセシビリティ

• すべてのインタラクティブ要素に VoiceOver ラベル
• 論理的な読み取り順序
• 太字テキスト設定を尊重
• モーション削減が装飾的なアニメーションを無効化
• すべてのジェスチャーに代替アクセスパスを用意

ナビゲーション

• 3～5個のトップレベルセクションにタブバーを使用
• ハンバーガー/ドロワーメニューなし
• タブバーはナビゲーション中も表示
• 戻るスワイプが全体で機能
• タブ間で状態を保持

コンポーネント

• 重大な決定のみアラートを使用
• Sheet には閉じるパス（ボタンおよび/またはスワイプ）を用意
• リスト行 >= 44pt の高さ
• 破壊的なボタンは .destructive ロールを使用

プライバシー

• 許可をコンテキスト内でリクエスト（起動時ではない）
• システム許可ダイアログの前にカスタム説明を用意
• 他のプロバイダーと共に Apple でサインインを提供
• アカウントなしで基本機能を使用可能
• トラッキング時に ATT プロンプトを表示、拒否を尊重

システムインテグレーション

• アプリが中断を適切に処理（電話、バックグラウンド、Siri）
• アプリコンテンツが Spotlight にインデックスされている
• 共有可能なコンテンツに対して共有シートが利用可能

参考資料

トピック	参考
タッチターゲット、セーフエリア、CollectionView	Layout System
TabBar、NavigationController、Modal	Navigation Patterns
StackView、Button、Alert、Search、ContextMenu	UIKit Components
CAShapeLayer、CAGradientLayer、Core Animation	Graphics & Animation
Dynamic Type、Semantic Colors、VoiceOver	Accessibility
許可、位置情報、共有、ライフサイクル、触覚フィードバック	System Integration
Metal シェーダー & GPU	Metal Shader Reference
SwiftUI HIG、コンポーネント、パターン、アンチパターン	SwiftUI Design Guidelines
オプショナル、プロトコル、async/await、ARC、エラーハンドリング	Swift Coding Standards

---

Swift、SwiftUI、UIKit、SF Symbols、Metal、および Apple は Apple Inc. の商標です。SnapKit はそれぞれの所有者の商標です。