9ura00

iPhone のウィジェットのタップで、実機でだけ起きた3つの落とし穴

Sheet Widget のウィジェットには、タップで動く機能がいくつかあります。

  • ウィジェットをタップすると、スプレッドシートやアプリが開く
  • (Pro)セルをタップすると、その値をコピーできる
  • (Pro)ウィジェットの更新ボタンで、データの再取得を試す

iOS 17 からウィジェットにボタンを置けるようになり、こうした機能が作りやすくなりました。ただ、作ってみると、当時のシミュレータや自動テストでは見つからず、実機のホーム画面で判明した問題が3つありました。同じところでつまずく人がいるかもしれないので、まとめておきます。

1. ウィジェットからのクリップボード書き込みが失敗した

「セルをタップしてコピー」は、最初、ウィジェットのボタン(App Intent)の処理の中で、そのままクリップボードに書き込む形で作りました。

UIPasteboard.general.string = value

ところが、当時の実機検証ではこれがエラーも出さずに失敗しました。処理は最後まで走るのに、クリップボードには何も入りません。保存した開発記録には外部の不具合報告への言及もありますが、今回はその原文を確認できていません。ここでは、Sheet Widget で確認した症状と実装上の回避策に限って説明します。

直し方:アプリを一瞬前に出してコピーする

ウィジェットの側では、どのセルが押されたか(行と列)だけをアプリに渡し、実際のコピーは、前面に出たアプリが行う形に変えました。

  1. ウィジェットのセルを、行と列を含んだ URL へのリンクにする
  2. タップすると Sheet Widget のアプリが開く
  3. アプリは、保存してあるシートの内容からその値を取り出してコピーする
  4. コピーしたあと、利用者が選んだ行き先(スプレッドシートを開く、など)に移る

現在の実装では、アプリ側のURL受信処理から UIPasteboard.general.string に書き込んでいます。この回避策の経緯は開発記録にありますが、今回すべてのOSでのコピー成功を再確認したわけではありません。

2. ボタンが、ウィジェットの長押しメニューを奪う

ウィジェット全体をタップできるようにするため、最初はウィジェット全体を、App Intent のボタンで包んでいました。

Button(intent: OpenAction()) {
    GridView(...)
}

これを実機のホーム画面に置くと、ウィジェットを長押ししても「ウィジェットを編集」のメニューが出ず、先にボタンが反応してしまうようになりました。当時のビュー構成では、全体を包むボタンとホーム画面の長押し操作が競合していました。ウィジェットの設定(表示するシートの切り替えなど)ができなくなるので、致命的でした。

ウィジェットのタップには、Sheet Widget では次のように使い分けています。

タップしたい場所 使うもの
ウィジェット全体 .widgetURL(...)
ウィジェットの一部(セルなど) Link(destination:)
小さなボタン(更新ボタンなど) Button(intent:) を採用し、長押しと合わせて検証

Sheet Widget の当時の記録では、更新ボタンの領域は長押しメニューと競合しなかったため、ボタンのままにしています。小さなボタンならすべての構成で競合しない、という一般的な保証ではありません。

3. 一部の設定でだけ、タップしても反応しない場所ができた

「セルをタップしてコピー」をオンにしているときは、ウィジェット全体のタップ先(.widgetURL)を nil にしていました。セルのリンクを優先させたかったからです。

ところが、.widgetURL はウィジェット全体に効く1つの設定です。nil にすると、セル以外の場所(ヘッダー、フッター、空のセル)まで巻き添えで、タップしても何も起きなくなりました。

直し方:コピー設定だけを理由に行き先を消さない

現在のコードでは、表示データがあるウィジェットについて、コピーのオン・オフにかかわらず全体の行き先を返します。ただしデータがまだない場合は nil、利用上限でロックされた場合は購入画面への行き先を返すため、「どんな状態でも必ず同じURLを返す」という実装ではありません。

セルのコピー処理は、アプリ側の copyCell にまとめています。現在の処理を整理すると次のようになります。

タップした場所・状態 コード上の処理
コピー有効の値入りセル 設定ID・行・列をURLで渡し、保存済みの値をアプリでコピー
コピー有効の空欄セル コピー用リンクは置くが、アプリ側ではクリップボードを書き換えず空欄の案内を表示
結合セル 結合の先頭セルに、結合範囲を覆うリンクを配置。覆われたセルには重ねて置かない
ヘッダー・フッターなど ウィジェット全体の行き先で処理

空欄でも、コピー処理の後には設定した行き先へ進むコードになっています。また、コピー元はアプリに保存済みのデータです。タップのたびにGoogle Sheetsを再取得して最新値をコピーする仕組みではありません。

自動テストで確認することと、画面で確認すること

既存の WidgetTapURLTests には、設定ID・行・列をURLへ変換して読み戻すテストと、スプレッドシートを開く行き先の検証があります。実装では、行き先URLのスキームが https、ホストが docs.google.com と完全一致する場合に受け付けています。似たホスト名や別スキームを拒否するテストもあります。

これらはURLの組み立て・解釈のテストで、ホーム画面の長押し競合や実際のクリップボードへの書き込みを保証するものではありません。2026年10月16日の更新では、保存した開発記録、現在の実装、テストコードを読み直しました。今回の実機・シミュレータでの再確認やXCTestの再実行は行っていません。

教訓:タップまわりを触ったら、実機で全部押す

3つとも、XCTest やシミュレータでは見つけられず、実機のホーム画面に置いて、実際に指で押して初めて分かった問題でした。

それ以来、ウィジェットのタップまわりを変えたときは、次のことを実機で確認するようにしています。

  • ウィジェットの全部の場所(ヘッダー、フッター、空のセル、値のあるセル、ボタン)をタップする
  • 長押しで「ウィジェットを編集」が出るか
  • 設定(コピーのオン・オフなど)を切り替えて、同じことを繰り返す

ウィジェットは「見るもの」から「触れるもの」になってきていますが、触れる部分には、アプリ本体とは違う制約がまだ多くあります。


Sheet Widget は App Store で公開しています。

← ブログの一覧へ