App Intentの基礎知識

App Intentの基礎知識

App Intentフレームワークの概要と、Appleのデベロッパプラットフォームにおいてますます重要性が高まっているこのフレームワークの役割について学びましょう。このセッションでは、インテント、エンティティ、クエリなどのコア概念を基本から解説します。これらの要素が連携することで、Spotlightやショートカットなどのソフトウェア機能とアクションボタンなどのハードウェア機能を実現するための、Appleデバイスを通じたアプリとApp Intentの統合が可能になります。今後Apple Intelligenceをアプリに統合する際のゲートウェイとしてApp Intentを活用する方法についても解説します。

関連する章
- 0:00 - イントロダクション
- 0:45 - App Intentエコシステム
- 2:47 - フレームワークの紹介
- 21:15 - 仕組み
リソース
関連ビデオ

WWDC25
- インタラクティブなスニペットのデザイン
- App Intentを使用したショートカットおよびSpotlight向け機能の開発
WWDC24
Swift Intelligence Frameworksチームのエンジニアリングマネージャー Jamesです App Intentについて説明できることをうれしく思います Apple Intentはシステム全体そしてすべてのAppleプラットフォームでのアプリの見つけやすさや可視性また機能を向上させるためのフレームワークです最初にますます重要になっている Appleデベロッパエコシステムにおける Apple Intentの役割について説明します
次にフレームワークを使いシステムを通じてアプリのアクションやエンティティをユーザーに提供する方法について説明します最後にApple Intentを記述する際に知っておいた方がよいいくつかの情報を提供します
App Intentの使い方を説明する前に「なぜApp Intentなのか」を説明します App Intentはアプリケーションに機能を構築するためだけのフレームワークではありませんアプリの機能をシステム全体に拡張するためのエコシステムです
App Intentを使用することで Spotlightでカスタマイズした結果を提供したりアクションボタンにコンテキストに応じたエクスペリエンスを提供したりウィジェットに構成機能やインタラクティブな機能を提供したりコントロールセンターのコントロールに簡単にアクセスできるようにしたりできます Apple Pencil Proにカスタムアクションも設定できます
今年からSpotlightを使ってアプリのアクションをMac上のどこからでも呼び出せるようになりました
App Intentフレームワークを使用するとユーザーがアプリを開いていなくてもこれらの豊富な機能を届けることができますまずはアプリで実行可能なアクション例えばメモを開いたりワークアウトを開始したり買い物リストにアイテムを追加したりといったアクションから始まりますこれらはいわばアプリの動詞でもう想像がついているかもしれませんが App Intent 略してインテントを作成することでそれらを記述することができますインテントを作成する時はアクションが正常に実行されるようにシステムに追加情報を提供しますインテントはパラメータと戻り値を受け取ることができますこれらの入力と出力は Swiftネイティブの型またはアプリ内で定義された型にすることができます App Intentでは 2種類の値を作成できます定数の値のセットを持つ型には AppEnumを使用しますダイナミックタイプには AppEntityを使用します AppEnumとAppEntityはいわばアプリの名詞ですアプリショートカットは重要なインテントをさらに高めてそれらをよりアクセスしやすくまた見つけやすくしますアプリショートカットは Spotlightでの検索やSiriの使用アクションボタンの構成などの際に表示されますこれらはいわばアプリの文とみなすことができインテントとそれを動かすために必要なパラメータでできています学習するのに最も優れた方法は実際にやってみることです私の最初のインテントを作成するために何が必要だったかを見てみましょう私は家族と一緒に旅行するのが好きで世界中の有名な観光名所をチェックするためのアプリを開発していますアプリにはいくつかのセクションがあります有名な観光名所のリストをスクロールして地図上でチェックしたり作成したコレクションを表示したりできます多くのユーザーは観光名所のグリッドをスクロールして楽しんでいますそこでApp Intentを作成してアプリのこの部分にもっと簡単に直接移動できるようにしようと思いますどうすればよいでしょうか最初に App Intentプロトコルを採用した新しい構造体を定義します App Intentの最小要件はタイトルとperformメソッドです
タイトルはローカライズされた一意の文字列でインテントの名前として表示されます performメソッドにはインテントのロジックが含まれています共有ナビゲータを使用して観光名所ビューを開きますナビゲーションはメインスレッドで行う必要がありますそのため @MainActorでperformをマークします
performメソッドは IntentResultを返します IntentResultには Siriが話すことができるダイアログや表示するビュースニペットなど色々なものを含めることができますデフォルトではインテントを実行してもアプリはフォアグラウンドで実行されませんそのためダイアログやスニペットはアクションの結果を表示する優れた方法です
このインテントはアプリ内の画面に移動できるように設計されているため実行時にアプリが開くようにインテントを設定します新しいsupportedModesプロパティを foregroundに設定しインテントが実行される前にアプリが開くようにします最初のインテントに必要なことは以上ですアプリをインストールしたらインテントはショートカットにあります新しいショートカットを作成し先ほどのナビゲーションインテントを追加します実行するとアプリがフォアグラウンドで実行され観光名所ビューに直接移動します私のアプリにはコレクションを表示したり観光名所を地図上に表示したりするためのセクションもありますインテントによってアプリのそれらのセクションにも移動できたらいいですね私のアプリでは単純なSwiftの列挙を使用してセクションをモデル化していますこの型をフレームワークと互換性のあるものにするため AppEnumプロトコルを採用します AppEnumにはいくつかの要件しかありません文字列からインスタンス化できる必要があるので Stringの生の値を追加します TypeDisplayRepresentationで型全体を記述します caseDisplayRepresentationで列挙の各ケースを記述します
この情報はコンパイル時に使用されるためこれらの表現は定数値である必要があります
ここでNavigationOptionを保持するための新しい変数を追加しますこれをインテントパラメータにするため @Parameter属性を追加しますインテントパラメータはインテントの入力となり必須またはオプションにすることができますここでは必須にしましたそのため実行時にperformを呼び出す前にパラメータに値があることが確認されます
解決されたNavigationOptionを使用するようにperformメソッドを書き換えますそして新しいアクションに合わせてタイトルを変更します
ショートカットに戻ると Navigation Optionが編集可能なパラメータとして表示されますインテントを実行するとセクションを入力するように求められます「Map」を選択すると該当するビューが直接開きます App Intentフレームワークの型は詳細にカスタマイズできるようになっていますこのため構成要素をすばやく配置して機能を改良することができますここで使い勝手をよくするためにいくらかの追加情報をインテントに追加します
デフォルトではショートカットを開くと各パラメータが行として表示されます行をタップするとその型の値のリストが表示されますこれでも問題ありませんがさらに機能を改良することができます
AppEnumでは各列挙ケースにタイトルしか必要ありませんがアイコンなどの追加情報を使用して構成することもできます
これを行うには DisplayRepresentation イニシャライザを使用する必要があります次に各ケースに記号を追加します再度実行するとショートカットのピッカーに画像が表示されるようになりますインテントはパラメータサマリと呼ばれる流暢な文のような表現を使って構成できますパラメータサマリではアクションとそのパラメータが判読可能な方法で記述されます
パラメータが文字列に挿入されたサマリを作ってみましょうショートカットに選択可能なパラメータが行に埋め込まれたサマリが表示されもっと便利なアクションの説明となっています
実際のところこれではまだ文章とはいえませんパラメータにカスタムタイトルを追加してこれを修正できます
値をリクエストする時に表示するカスタムダイアログも追加しておきましょう今年から必要なすべてのパラメータが含まれたパラメータサマリをインテントに実装するとユーザーがMac上のSpotlightからアクションを実行できるようになりました Spotlightに追加された新機能について詳しくはこちらのセッションをご覧ください
アプリのアクションをインテントとしてモデル化することでユーザーが強力なショートカットや自動化機能を構築できるようにしますただしインテントがアプリの核となるものである場合アプリをインストールするとすぐそれらを利用できるようにする必要がありますこれらはアプリショートカットを採用することで提供できます
アプリショートカットはApp Intentを自動的にシステム全体に公開する型ですアプリショートカットは Spotlightで検索する時に特に便利ですアプリショートカットはトリガフレーズを使って Siriに実行させることもできますしアクションボタンやApple Pencilのスクイーズでも実行することができますアプリショートカットはユーザー設定なしでショートカットアプリに表示されますそして一番良いところは数行のコードでビルドできるところですその方法を見てみましょう
アプリではAppShortcutsProviderを使ってアプリショートカットを提供しますアプリですべてのアプリショートカットを含む 1つのプロバイダを定義する必要がありますアプリショートカットはインテントのインスタンスを受け取ることができフレーズのリストタイトル画像を取ることもできますフレーズをSiriに発声または入力してアプリショートカットを実行できます各フレーズにはapplicationName プレースホルダを含める必要がありますフレーズには最大1つのインテントパラメータを含めることができます指定した場合はその型の各値に対してアプリショートカットが作成されます
アプリショートカットの作成に必要なのはこのシンプルな構造体だけですショートカットの新しいセクションにアプリのアプリショートカットが表示されますフレーズは作成されるアプリショートカットに影響を与えますパラメータなしでフレーズを指定するとタイトルと画像名を使用してアプリショートカットが作成されます私はAppEnumを使用してフレーズを指定したため各ケースに対してアプリショートカットが作成されます
これでSiriやSpotlightでインテントを実行できるようになりましたアプリショートカットはインテントを見つけてもらいやすくする優れた方法ですアプリショートカットの構築方法の詳細は WWDC23のこちらのセッションをご覧ください
観光名所はアプリの主要なコンセプトですインテントからそれらに誘導できたら最高ですナビゲーションオプションは一定でしたが観光名所は動的であるため AppEnumを使用できません代わりに AppEntityを作成して観光名所をモデル化します
アプリにはすでに観光名所の型がありますその型をAppEntityに適合させることもできますがここでは Landmark Entity構造体を新たに作成してみますこの型は App Intentと基になっているデータモデルの間の橋渡しとして機能します
AppEntityは識別が必要になるため IDを追加しますこのIDが永続的であることが重要になりますこのIDを使用してエンティティのインスタンスを検索することができますこれについては後で説明しますインテントにはパラメータを指定できましたがエンティティには@Property属性で示されたプロパティを指定できますこれらはショートカット内でユーザーに公開され検索アクションやフィルターアクションで使用できますこれらの値をデータモデルから設定することもできますが今年からエンティティプロパティにゲッタを追加できるようになりました新しい@ComputedProperty属性を使用しますこれらの型の間で値をコピーしなくてもデータモデルに従うことができます AppEnumと同様に App Entityでも型の表現と型のインスタンスが必要になります
App Entityではクエリと呼ばれるもう1つの情報が必要になります
値がわかっているAppEnumとは異なり App Entityは動的です観光名所はアプリにいくつでも追加できますシステムはクエリを使用することでエンティティを推測できますこれはいくつかの異なる質問に答えることによって行われます最初の質問は「どのようなエンティティがありますか」ですクエリの仕事はその質問に回答し一致するエンティティのコレクションを返すことです
クエリではこのような多くの質問がサポートされています例えば Entity String Queryは「この文字列に一致するエンティティはありますか」とたずねますまたEntity Property Queryは「この州のすべての観光名所は何ですか」とたずねます
すべてのクエリは非常に具体的な 1つの質問に答える必要があります「このIDのエンティティは何ですか」このように質問することでシステムはエンティティを一意に参照でき必要な時だけ解決することができます Entity Queryプロトコルに準拠した型を作成することでクエリを提供できます entities(for:)メソッドは「このIDのエンティティは何ですか」という質問にクエリがどのように答えるかを示しています IDの配列を受け取りエンティティインスタンスの配列を返します「どのようなエンティティがありますか」という質問については後で説明します多くの場合クエリはローカルデータベースやその他の依存関係にアクセスしてインスタンスをフェッチする必要があります @Dependency属性を使用して依存関係をクエリに挿入できます共有のApp Dependency Managerで依存関係を登録する必要があります依存関係はアプリのライフサイクルのできるだけ早い段階で登録します Landmark AppEntityを作成することができましたこれをインテントで使用できます旅行している時に最寄りの観光名所が何であるかわかれば最高ですそれを教えてくれる App Intentを作成します最初に基本的な ClosestLandmarkIntentから始めましょう最寄りの観光名所をデータモデルからフェッチする必要があります依存関係はインテントでも使用できるため依存関係を追加します performメソッドに Landmark Entityの ReturnsValueを追加しますインテントパラメータとして使用する型はインテントから返すこともできます戻り値を複数のステップから成るショートカットなどの別のインテントの入力として使用することができますここではダイアログとビュースニペットも返すようにしますこれによりインテントがインテントの結果を表示したり話したりできるようになります最後に performメソッドを実装します最寄りの観光名所を見つけたらエンティティやダイアログまたビューを含む結果が返されるようにしますダイアログとビューの両方を提供することでインテントを呼び出す方法に関わらずユーザーがいつでも最寄りの観光名所を確実に見つけられるようにしますこのインテントにアプリショートカットを作成しておけばこのインテントをもっと簡単に実行できますこれでユーザーは携帯をポケットに入れたままでも SiriやSpotlightでインテントに簡単にアクセスできますインテントやエンティティまたクエリは App Intentの構成要素です各プロトコルの下にはさらにプロトコルや設定がありますそれを使用することで追加の機能を提供できます先ほどのAppEntityをさらに改良して追加の機能を提供する方法を見てみましょう最寄りの観光名所の写真を簡単に表示できるようにしたいと思いますそのためにショートカットアプリを使用できますまずショートカットを作成して Find Closest Landmarkインテントを追加し結果を確認するために Show Contentアクションを追加しますこのアクションはインテントの結果を受け取りそれをレンダリングしますこのアクションはデフォルトではLandmark Entityの表現を表示しますが任意のエンティティプロパティを選択してレンダリングすることもできます
Landmark Entityは画像を直接保持しているわけではなく画像までのパスを保持しています Transferableプロトコルを使用してエンティティに対して画像表現を宣言できます Transferableは型に対して様々なデータ表現を記述するための宣言型プロトコルですこれらの表現を使用してアプリ間でデータを共有できます型のTransferRepresentationの一部として画像データを提供しますショートカットに戻りましょうエンティティの画像表現を表示できるようになりましたショートカットを実行すると観光名所の画像が表示されます画像表現を宣言することにはさらにメリットがあります写真を受け取るアクションの入力としてこの画像の値を使用できます他のアプリのアクションでも構いません Transferableの詳細についてはこちらのセッションをご覧ください
システム内でエンティティを見つけやすくするためにもう1箇所エンティティを変更したいと思います Spotlightにはアプリ間で実行される強力なセマンティック検索が搭載されていますエンティティをSpotlightに提供することでシステムによるコンテンツの理解を向上できますエンティティをインデックス化するには IndexedEntityプロトコルを採用します IndexedEntityはCore Spotlight 属性セットを含むAppEntityです
今年からSpotlightのインデックスキーをプロパティに直接追加できるようになりましたプロパティに注釈を付けることでSpotlightにより関連性の高い情報を表示できますインデックス化したエンティティを提供するとフレームワークによって検索可能な項目と属性セットが作成されますエンティティを提供したらそれらをSpotlightで検索できますデフォルトではエンティティをタップするとアプリがフォアグラウンドで実行されますこの機能をさらに改良して観光名所の詳細ビューが直接開くようにしますまず OpenIntentプロトコルに準拠したインテントを作成しますこのプロトコルを採用するインテントは実行する前に自動的にアプリを開きますそのため対応モードを追加する手順はスキップします OpenIntentには targetパラメータが必要です Spotlightでエンティティをタップすると一致するOpenIntentが存在する場合はそれが実行されます
ナビゲータを呼び出す代わりにナビゲーション専用に設計された新しい TargetContentProvidingIntentプロトコルを採用できるようになりましたこれらのインテントには performメソッドは必要ありません代わりにonAppIntentExecution修飾子をビューにアタッチしますクロージャ内ではインテントのパラメータを使用して SwiftUIナビゲーションを実行します
これで Spotlightから観光名所をタップすると観光名所の詳細ビューに直接移動できるようになりましたこのセクションのまとめとしてクエリとそれがどのようにエンティティを提供するかについて少し説明しますこれを実際に確認するために観光名所を開く新しいアプリショートカットを作成します新しいアプリショートカットを2つのフレーズとともにプロバイダに追加しました一方には観光名所パラメータを含めもう一方には含めませんでしたところがアプリショートカットを実行しても選択する観光名所が表示されませんお察しの通り観光名所を表示するにはクエリを使用する必要がありますオプションのsuggestedEntitiesメソッドを EntityQueryに実装してユーザーのお気に入りの観光名所を返しますインテントを再度実行すると提案されたエンティティのリストが表示されます提案されたエンティティには別の使い方もありますこのインテントにパラメータ化したフレーズを追加したことを思い出してください updateAppShortcutParametersメソッドをプロバイダで呼び出すことによって提案された各エンティティに対してアプリショートカットを生成できますこれでSiriとショートカットを使ってお気に入りの観光名所に直接かつ簡単に移動できるようになりましたクエリはエンティティに関するその他の多くの質問に答えることができますエンティティすべてがメモリに収まる場合は EnumerableEntityQueryを使用してそれらすべてを返すことができますそこからApp Intentがより複雑なクエリを導き出すことができるようになります EntityPropertyQueryでは一連のプレディケートに従ってソートされたエンティティのリストを返すことができますここでは EntityStringQueryを実装して文字列からのエンティティの検索をサポートします名前または説明が文字列と一致する観光名所のリストが返されるようにしますこれにより観光名所が必要になるインテントを設定する際にすべての観光名所を検索できるようになります今日はApp Intentフレームワークとその多くの機能のさわりの部分を紹介したにすぎません App Intentのドキュメントをご覧になりフレームワークを使用してユーザーを喜ばせるその他の様々な方法をご確認ください最後に App Intentを駆動しているアーキテクチャに関する情報を提供します App Intentでアプリを構築する場合コードが唯一の信頼できる情報源となります App Intentに設定ファイルや構成ファイルは必要ありません Swiftソースコードはビルド時に読み取られ App Intent表現が生成されますこの表現はアプリまたはフレームワーク内に保存されますアプリがインストールされるとシステムはこのデータを使用してアプリの機能を理解しますその際にアプリを実行する必要はありませんこれがどのように機能するか 1つのインテントを見てみましょうインテントの名前はアクションの一意のIDになりますインテントのタイトルはユーザーがインテントを区別するのに役立ちます performメソッドのリターン署名にはインテントの結果をレンダリングする方法が説明されていますこのプロセスは実行時ではなくビルド時に行われるため特定の値には定数値を指定する必要があります例えばインテントのタイトルは一定である必要があります関数や計算型プロパティを呼び出すとエラーになりますこの処理はアプリのターゲットごとに個別に行われますターゲット間でApp Intentの型を適切に共有するために注意が必要なことがいくつかあります昨年はアプリやApp Intentの拡張機能にフレームワーク内で定義された App Intentの型を参照する機能が追加されましたが今年からApp Intentを Swiftパッケージやスタティックライブラリに追加できるようになったことをお知らせできることをうれしく思いますターゲット間でApp Intentの型を使用する場合各ターゲットに関する追加情報をランタイムに提供する必要がありますこれにより型が適切にインデックス化され検証されるようになりますこれがどのように行われるのか詳しく見てみましょうこのアプリにはすべてのApp Intentコードを含む1つのターゲットしかありません新しいApp Intent拡張機能を追加していくつかのインテントをホストしましょういずれのターゲットも観光名所へのアクセスが必要になりますそのため Swiftパッケージを作成しそれにLandmark Entityを移動しますターゲット間で型を共有するには App Intentパッケージとして各ターゲットを登録する必要がありますまずエンティティと同じターゲットに App Intentパッケージを作成します別のApp Intentパッケージをアプリターゲットに追加します含まれているパッケージのリストを提供できます先ほど作成したものを含めます最後に拡張機能から同じことを行いますこれにより App Intentランタイムがパッケージで定義されたすべての型に適切にアクセスできるようにしますスタティックライブラリにコンパイルされていないコードを参照する場合は App Intentパッケージを使用する必要があります
今日の話の締めくくりとして今回App Intentを初めて見たという方は最初のアプリショートカットをアプリに追加するなど簡単なことから始めてそこからフレームワークについて詳しく調べユーザーに最大のメリットをもたらす機能は何かを確認してください今年は App Intentについて他にも素晴らしいセッションがありますご視聴ありがとうございました

struct NavigateIntent: AppIntent {
    static let title: LocalizedStringResource = "Navigate to Landmarks"

    static let supportedModes: IntentModes = .foreground

    @MainActor
    func perform() async throws -> some IntentResult {
        Navigator.shared.navigate(to: .landmarks)
        return .result()
    }
}

5:02 - Navigation Option App Enum

enum NavigationOption: String, AppEnum {
    case landmarks
    case map
    case collections

    static let typeDisplayRepresentation: TypeDisplayRepresentation = "Navigation Option"

    static let caseDisplayRepresentations: [NavigationOption: DisplayRepresentation] = [
        .landmarks: "Landmarks",
        .map: "Map",
        .collections: "Collections"
    ]
}

5:38 - Navigate Intent with Parameter

struct NavigateIntent: AppIntent {
    static let title: LocalizedStringResource = "Navigate to Section"

    static let supportedModes: IntentModes = .foreground
  
    @Parameter var navigationOption: NavigationOption

    @MainActor
    func perform() async throws -> some IntentResult {
        Navigator.shared.navigate(to: navigationOption)
        return .result()
    }
}

6:57 - Case Display Representations with Images

static let caseDisplayRepresentations = [
    NavigationOption.landmarks: DisplayRepresentation(
        title: "Landmarks",
        image: .init(systemName: "building.columns")
    ),
    NavigationOption.map: DisplayRepresentation(
        title: "Map",
        image: .init(systemName: "map")
    ),
    NavigationOption.collections: DisplayRepresentation(
        title: "Collections",
        image: .init(systemName: "book.closed")
    )
]

7:28 - Navigation Option With Parameter Summary

struct NavigateIntent: AppIntent {
    static let title: LocalizedStringResource = "Navigate to Section"

    static let supportedModes: IntentModes = .foreground
  
    static var parameterSummary: some ParameterSummary {
        Summary("Navigate to \(\.$navigationOption)")
    }
  
    @Parameter(
        title: "Section",
        requestValueDialog: "Which section?"
    )
    var navigationOption: NavigationOption

    @MainActor
    func perform() async throws -> some IntentResult {
        Navigator.shared.navigate(to: navigationOption)
        return .result()
    }
}

9:22 - App Shortcuts Provider and Navigation Intent App Shortcut

struct TravelTrackingAppShortcuts: AppShortcutsProvider {
    static var appShortcuts: [AppShortcut] {
        AppShortcut(
            intent: NavigateIntent(),
            phrases: [
                "Navigate in \(.applicationName)",
                "Navigate to \(\.$navigationOption) in \(.applicationName)"a
            ],                
            shortTitle: "Navigate",
            systemImageName: "arrowshape.forward"
        )
    }
}

11:02 - Landmark Entity

struct LandmarkEntity: AppEntity {
    var id: Int { landmark.id }

    @ComputedProperty
    var name: String { landmark.name }

    @ComputedProperty
    var description: String { landmark.description }
  
    let landmark: Landmark
  
    static let typeDisplayRepresentation = TypeDisplayRepresentation(name: "Landmark")

    var displayRepresentation: DisplayRepresentation {
        DisplayRepresentation(title: "\(name)")
    }
  
    static let defaultQuery = LandmarkEntityQuery()
}

13:19 - Landmark Entity Query

struct LandmarkEntityQuery: EntityQuery {
    @Dependency var modelData: ModelData
  
    func entities(for identifiers: [LandmarkEntity.ID]) async throws -> [LandmarkEntity] {
        modelData
            .landmarks(for: identifiers)
            .map(LandmarkEntity.init)
    }
}

13:50 - App Dependency Manager

@main
struct LandmarksApp: App {    
    init() {
        AppDependencyManager.shared.add { ModelData() }
    }
}

14:18 - Closest Landmark Intent

struct ClosestLandmarkIntent: AppIntent {
    static let title: LocalizedStringResource = "Find Closest Landmark"

    @Dependency var modelData: ModelData

    @MainActor
    func perform() async throws 
        -> some ReturnsValue<LandmarkEntity> & ProvidesDialog & ShowsSnippetView {
        
        let landmark = try await modelData.findClosestLandmark()

        return .result(
            value: landmark,
            dialog: "The closest landmark to you is \(landmark.name)",
            view: ClosestLandmarkView(landmark: landmark)
        )
    }
}

15:18 - Closest Landmark App Shortcut

AppShortcut(
    intent: ClosestLandmarkIntent(),
    phrases: [
        "Find closest landmark in \(.applicationName)"
    ],
    shortTitle: "Closest landmark",
    systemImageName: "location"
)

16:33 - Transferable

extension LandmarkEntity: Transferable {
    static var transferRepresentation: some TransferRepresentation {
        DataRepresentation(exportedContentType: .image) {
            return try $0.imageRepresentationData
        }
    }
}

17:31 - Indexed Entity

struct LandmarkEntity: IndexedEntity {
    // ...
    
    @Property(
        indexingKey: \.displayName
    )
    var name: String

    @Property(
        indexingKey: \.contentDescription
    )
    var description: String
}

18:17 - Open Landmark Intent

struct OpenLandmarkIntent: OpenIntent, TargetContentProvidingIntent {
    static let title: LocalizedStringResource = "Open Landmark"

    @Parameter(title: "Landmark", requestValueDialog: "Which landmark?")
    var target: LandmarkEntity
}

struct LandmarksNavigationStack: View {
    @State var path: [Landmark] = []

    var body: some View {
        NavigationStack(path: $path) {}
        .onAppIntentExecution(OpenLandmarkIntent.self) { intent in
            path.append(intent.target.landmark)
        }
    }
}

19:24 - Open Landmark App Shortcut

AppShortcut(
    intent: OpenLandmarkIntent(),
    phrases: [
        "Open \(\.$target) in \(.applicationName)",
        "Open landmark in \(.applicationName)"
    ],
    shortTitle: "Open",
    systemImageName: "building.columns"
)

19:39 - Suggested Entities

struct LandmarkEntityQuery: EntityQuery {
    // ...

    func suggestedEntities() async throws -> [LandmarkEntity] {
        modelData
            .favoriteLandmarks()
            .map(LandmarkEntity.init)
    }
}

20:06 - Update App Shortcut Parameters
```
TravelTrackingAppShortcuts.updateAppShortcutParameters()
```

20:25 - EnumerableEntityQuery

extension LandmarkEntityQuery: EnumerableEntityQuery {
    func allEntities() async throws -> [LandmarkEntity] { 
        // ...
    }
}

20:36 - EntityPropertyQuery

extension LandmarkEntityQuery: EntityPropertyQuery {
    static var properties = QueryProperties {
        // ...
    }

    static var sortingOptions = SortingOptions {
        // ...
    }

    func entities(
        matching comparators: [Predicate<LandmarkEntity>],
        mode: ComparatorMode,
        sortedBy: [Sort<LandmarkEntity>],
        limit: Int?
    ) async throws -> [LandmarkEntity] {
        // ...
    }
}

20:44 - EntityStringQuery

extension LandmarkEntityQuery: EntityStringQuery {
    func entities(matching: String) async throws -> [LandmarkEntity] {
        modelData
            .landmarks
            .filter { $0.name.contains(matching) || $0.description.contains(matching) }
            .map(LandmarkEntity.init)
    }
}

23:10 - App Intents Package

// TravelTrackingKit
public struct TravelTrackingKitPackage: AppIntentsPackage {}
public structaLandmarkEntity: AppEntity {}

// TravelTracking
struct TravelTrackingPackage: AppIntentsPackage {
    static var includedPackages: [any AppIntentsPackage.Type] {
        [TravelTrackingKitPackage.self]
    }
}
struct OpenLandmarkIntent: OpenIntent {}

// TravelTrackingAppIntentsExtension
struct TravelTrackingExtensionPackage: AppIntentsPackage {
    static var includedPackages: [any AppIntentsPackage.Type] {
        [TravelTrackingKitPackage.self]
    }
}
struct FavoriteLandmarkIntent: AppIntent {}

関連する章

リソース

関連ビデオ

WWDC25

WWDC24