App Intentsを実装しよう

yidev 横浜iPhone開発者勉強会 第4部 - 第31回勉強会

Transcript

1. App Intentsを実装しよう 野瀬田 裕樹（@ynoseda）
2. Speaker 野瀬田 裕樹（@ynoseda） 合同会社DMM .com 開発統括本部 アプリ開発室所属 モバイル全般やってます （iOS/Android/Flutter）
3. Siri AIで AppIntent 話題になりましたよね
4. App Intentsとは • OSがアプリの機能を見つけられるようにする機能 • Siri/Shortcuts/Spotlight/Widgetなど様々な箇所で使われる • iOSアプリのMCPサーバーみたいなもの （対応するとAIがアプリを使えるようになる） • iOS 16.0+
5. iOS 16.0+
6. かなり前からあるよね
7. ということは
8. もう実務で使えますね
9. 詳しく見ていきましょう
10. （以降anyAppleOS 27+を含みます）
11. App Intentsの基本要素 • テスト：App Intents Testingを使用 • 何かの実行（アプリの動詞）：AppIntentプロトコルを実装 • 何らかの値（アプリの名詞）：App entities, App enumsを実装 • SiriやSpotlightなどとの統合：必要に応じて追加実装
12. AppIntentの実装 • AppIntentプロトコルで必要な分を実装するだけ protocol AppIntent : … { associatedtype PerformResult : IntentResult static var title: LocalizedStringResource { get } static var openAppWhenRun: Bool { get } static var supportedModes: IntentModes { get } static var authenticationPolicy: IntentAuthenticationPolicy { get } static var isDiscoverable: Bool { get } associatedtype SummaryContent : ParameterSummary static var parameterSummary: Self.SummaryContent { get } static var description: IntentDescription? { get } func perform() async throws -> Self.PerformResult
13. AppIntentのプロパティ static var title: LocalizedStringResource • Shortcutsアプリなどで表示されるタイトル • 人間が読める形式にする必要がある
14. AppIntentのプロパティ func perform() async throws -> some IntentResult? • App Intentsが実行されたときに呼び出される関数 • 返り値も設定できる
15. とりあえず OSから呼ばれたいだけなら 最低限必要なのはこれだけ
16. 残りはオプション
17. AppIntent関連は ドキュメントも豊富
18. 関連する公式ドキュメント • 最初のApp Intentを作成する https://developer.apple.com/documentation/appintents/creating-your-first-app-intent • App Intentの作り方を基礎から記述してくれている • ここから読むのがおすすめ
19. 関連する公式ドキュメント • アプリのカスタムデータ型をAppEntityとして定義する https://developer.apple.com/documentation/appintents/defining-app-entities-for-your-custom-data-types • AppEntityの定義の仕方を詳しく記述してくれている • AppIntentで受け渡しするデータ型を定義したくなったら読む
20. 関連する公式ドキュメント • Apple IntelligenceとSiriに状況に応じた情報を提供する https://developer.apple.com/documentation/appintents/providing-contextual-cues-to-apple-intelligence-and-siri • 色々な追加情報の渡し方を説明してくれている • あるAppEntityがどういうデータなのか？ • 画面認識で「これを〜〜して」の「これ」は何？ • などをシステムに理解してもらうための工夫が記載されている • Transferable, ValueRepresentation, appEntityIdentifier(̲:), appEntityUIElements(̲:) などが気になったら読む
21. 関連する公式ドキュメント • Apple Intelligence がアクションやコンテンツを検出できるよ うにする https://developer.apple.com/documentation/appintents/making-actions-and-content-discoverable-by-apple-intelligence • AppIntent, AppEntity, AppEnumのschemaの説明 • AppIntentなどがどのような時に使われるべきかを指定できる • @AppIntent(schema: .photos.openAsset)のような schemaが何者なのかが知りたくなったら読む
22. 関連する公式ドキュメント • アプリのデータとアクションをシステムにdonateする（渡す） https://developer.apple.com/documentation/appintents/donating-your-apps-data-and-actions-to-the-system • AppIntent, AppEntityのdonateについての説明 • 「いつもの\(CustomIntent)やって」や関連する情報の提示など、 良い感じにOSが解釈できるようにするための追加情報を渡せる • donate(), IntentDonationManager, appEntityIdentifier, RelevantIntentManager, updateEntities(̲:for:)などが気に なったら読む
23. 関連する公式ドキュメント • SpotlightでAppEntityを利用できるようにする https://developer.apple.com/documentation/appintents/making-app-entities-available-in-spotlight • Spotlightの検索でAppEntityが引っ掛かるようにするための 工夫が記述されている • IndexedEntityによるindexやindexAppEntities(̲:priority:) による明示的なindex、CSSearchableItemAttributeSetな どSpotlightへのAppEntityのindexについての詳細が知りた くなったら読む
24. 実装
25. トラブル
26. iOS 26.5シミュレータ問題 • 多分iOS 26.5シミュレータで動かないバグがある • • （新卒研修のお題にしてたのに動かなくて発覚） 大人しく26.4とか古いものを使いましょう
27. Swift PMと相性悪い問題 • • WWDC25でSwift Packageに対応したよ！ と言っていたがうまく動かない • 普通にアプリと別のTargetに分離したframeworkにする分には動く • 一回だけちゃんと登録されたことがある （が、その後更新しても反映されなかったりして不安定） • 個人の環境の問題なのか、実機では問題ないのかは不明 誰か答え持ってたら教えてください
28. AppDependencyManager何者問題 • AppDependencyManagerで依存関係を注入できるが、説明がな さすぎて使いにくい • • App.initで注入するだけでなく、Widgetなら WidgetBundle.initなど実行するプロセスの大元のinitで全部同 じことを書く必要がありそう？ 一応使えるけどもうちょっとドキュメント欲しいよね
29. Localizeわかりにくい問題 • 実はAppShortcuts.xcstringsファイルに定義する必要がある • WWDCのセッションの中で言っていた以外は、 Xcodeのリリースノートぐらいにしか書いてない
30. Default MainActorと相性悪い問題 • Swift 6 x Strict Concurrency Checking=complete x Default Actor Isolation=MainActor の組み合わせで AppIntent の @Parameter が定義できない (swiftlang/swift/issues/76725) • AppIntentのコードに関してはDefault Actor Isolation設定をや めましょう
31. 色々あるけど AppIntentは良い物です
32. アプリの機能を AppIntentで提供すると AIがアプリを操作できる
33. AppIntent対応は AI対応の第一歩
34. ぜひやっていきましょう
35. 終わり