🙄

FlutterのShareExtensionを触った際の備忘録（初っ端からメンタルが、、、）

わたなお

2025/07/22に公開

 わかる！実に！わかるぞ！最高に「ハイ！」ってやつだ[1]
というわけで、お久しぶりです、わたなおです。今回はですね、FlutterなのにiOS側のみでShareExtensionを使用したいという狂気じみたことをやったので備忘録を書こうと思います。
あれ？前回の記事含め、Flutterである意味って、、、いや、気にしないことにしましょう。
お目汚しいたします、愚痴ですShareExtensionとかiOSでしかできない機能の資料、少なすぎません？？
タスクが終わったらタイトルの状態ですよ、、、

 ShareExtensionとは、、、ShareExtensionとは、⬇下の画像の黄色で囲まれた部分を押すことで表示されるUIで呼び出される処理とそのUIのことです。
よくエアドロで使うあの機能で写真アプリなどの列に自分のアプリを表示し、データを登録することが目標です。

 自作したくない自分が色々動いた結果Flutterにライブラリはあるようなのですが、説明が不十分だったのかiOSの変更などに追従できていなかったことで機能が実装できなかったので自作することにしました。

 機能の流れ共有データ（画像や音声）を選択し、共有用画面を開く
アプリのアイコンを選択
ここからあとの実装はShare Extensionがどういう機能であるのかに依存します。

 実装準備脳内でキューピー３分クッキング👶の曲を流しながら、以下の手順でShareExtensionを準備しましょう。（慣れれば30分以内でできます。10回ループするだけですね。）
Flutterで作成された、自作プロジェクトのios/Runner.xcworkspaceを起動します。名前が似ているのがありますが、白いアイコンの方を選んでください。
Xcodeのナビゲーターエリアの一番上にあるRunner（ディレクトリではないRunnerを選んでください）をクリックします。
右の方にあるProjectやTargetsの下にある+をクリックし、下のようなウィンドウが出てきます。そのフィルターにShare Extensionと入力し、先ほどのお馴染みのアイコンを選択します。


Swiftのプロジェクト作成のようなウィンドウが見えると思いますので、ShareExtensionと入力してください。以降の内容を揃えたいので同名でお願いします。
以上を実施後、自作プロジェクトのios配下にShareExtension、Xcodeのナビゲーターエリアに青色ディレクトリのアイコンでShareExtensionとあるはずです。これで、表示自体はされるはずなので試してみましょう。
見えましたね。これで実装の準備は完了です。

 できること・できないこと自分が調査した範囲でできることとできないことをまとめようと思います。不十分な可能性もありますが、その場合はコメントしていただけると助かります。

 できること
ShareExtensionを起動した要因を取得する（画像や音声など）
UserDefaultなどのiOS依存の機能を使用すること
デフォルトのUIの見た目を変更すること
独自の見た目を実装すること（ShareViewControllerが継承するクラスをUIViewControllerに変えます）
元アプリとデータなどを共有すること
PODでライブラリを追加する

 できないこと元となったアプリを起動すること（これ、やりたかった、、、 😭）

 外部ライブラリの追加方法今回、Flutterを使用しているため、Podfileに下記のように記載します。今回はAPI呼び出し時にTokenが欲しいのでFirebase/CoreとFirebase/Authを使用できるようにします。
target 'Runner' do
  use_frameworks!
  use_modular_headers!

  flutter_install_all_ios_pods File.dirname(File.realpath(__FILE__))
  target 'RunnerTests' do
    inherit! :search_paths
  end
end

target 'Share_Extension' do
  use_frameworks!
  pod 'Firebase/Core'
  pod 'Firebase/Auth'
  pod 'GoogleUtilities/AppDelegateSwizzler'
  pod 'GoogleUtilities/MethodSwizzler'
  pod 'GoogleUtilities/Network'
  pod 'GoogleUtilities/NSData+zlib'
  pod 'GoogleUtilities/Environment'
  pod 'GoogleUtilities/UserDefaults'
  pod 'GoogleUtilities/Reachability'
  pod 'GTMSessionFetcher'
end
今回はFlutterなのでPodfileですが、SPMでのやり方は考えたくないので書かないことにします。（後日できたら…）

 詳細な技術の話
 準備元からあるUIKit + Storyboardを使用します。UIViewControllerRepresentableを使えばSwiftUIも使えるかもしれないですが、そこまでする義理もないのでこれで行きます。
class ShareViewController: UIViewController {
  @IBOutlet weak var progressLoader: UIProgressView!
  @IBOutlet weak var loadingLabel: UILabel!
}
これで読み込み機能時の演出を作ります。チープでもいいでしょ。許せ、、、

 Firebaseの初期化とアプリ本体とログイン状況の共有この処理は必須級の関数です。リンク先のFirebaseのページを元に適切なKeyChainKeyを設定してください。
  func initFirebase() {
    FirebaseApp.configure()
    
    do {
      // KeyChainでアプリ本体とFirebase Authを共有
      try Auth.auth().useUserAccessGroup("KeyChainKey")
    } catch {
      // この処理の詳細は後述します orz
      closeView()
    }
  }
この関数を好きなタイミングで読んで欲しいのとFirebaseの処理を使う前までに必ず読み込まれて欲しいです。が、AppDelegateをここでは使用できないのでloadView()などで呼び出すことをおすすめします。

 API呼び出し部分と最重要処理この処理callApis()が呼び出される前に必ずFirebaseApp.configure()が呼び出されている必要があります。上の内容ができていれば大丈夫でしょうが一応、注意してください。
  /// どっかで呼ばれてるself.progressLoader.setProgress(0, animated: true)
  func closeView() {
    self.extensionContext!.completeRequest(returningItems: [], completionHandler: nil)
  }
  
  func callApis() {
    Task {
      defer {
        closeView()
      }

      do {
        guard let jwt = try? await Auth.auth().currentUser?.getIDToken() else {
          throw """
ログインしていません。
アプリでログイン後、再度、実行してください。
"""
        }
        
        DispatchQueue.main.async {
          self.loadingLabel.text = "次の情報の取得中..."
          self.progressLoader.setProgress(1/n, animated: true)
        }

 最重要処理１つ目self.extensionContext!.completeRequest(returningItems, completionHandler)とはこの処理を呼び出すことで自動でShareExtensionの画面を閉じることができます。手で閉じることもできますが、UXを損ねそうなので適切なタイミングでこれを呼び出すようにします。Concurrencyじゃないというのはびっくりしました。

 最重要処理２つ目DispatchQueue.main.async {}とはSwiftのUIKitではUIの更新のタイミングがメインのスレッドでないといけないのでメインスレッドに処理を入れ込むためにこれを書いています。まぁ、有名ですね。

 deferをしている理由実際の処理ではメッセージを表示して４秒後ぐらいで画面を閉じたいので、これを記載しています。各箇所で呼ぶより楽なのでこうしているってだけです。deferの中身は省略してます。

 まとめFlutter（iOS）でShareExtensionを使用する方法は、普通にSwiftでShareExtensionを入れてCocoaPodsでライブラリを入れる感じで大丈夫でした。もし、よろしければShareExtensionを使ってみるのはいかがでしょうか？
Flutterでは、２度とやらん、、、

脚注
アニメ「ジョジョの奇妙な冒険第３部スターダスト・クルセイダース」第48話 ↩︎

mutex Tech BlogPublication

東京大学発のスタートアップ株式会社mutex の Tech Blogです！

FlutterのShareExtensionを触った際の備忘録（初っ端からメンタルが、、、）

わかる！実に！わかるぞ！最高に「ハイ！」ってやつだ^[1]

`ShareExtension`とは、、、

自作したくない自分が色々動いた結果

機能の流れ

実装準備

できること・できないこと

できること

できないこと

外部ライブラリの追加方法

詳細な技術の話

準備

Firebaseの初期化とアプリ本体とログイン状況の共有

API呼び出し部分と最重要処理

最重要処理１つ目`self.extensionContext!.completeRequest(returningItems, completionHandler)`とは

最重要処理２つ目`DispatchQueue.main.async {}`とは

`defer`をしている理由

まとめ

Discussion