argent-ios-device-interact

物理 iPhone の操作

物理 iPhone の場合のみ、こちらをお読みください。ここに記載されていないすべての操作には、引き続き argent-device-interact が適用されます。

契約

• 観察によって画面が変化することはありませんが、変更操作では変化する場合があります。バックグラウンドにある対象では、describe と await-ui-element は前面に戻さずに失敗します。await-screen-idle は理由を示さず、settled: false を返します。button home の実行から 1 秒以内に行った最初の describe では、古いツリーが返される場合があります。その場合は、もう一度 describe してください。ジェスチャーと keyboard はアプリを前面に戻し、reactivated: true を返します。次の手順に進む前に、もう一度 describe してください。
• launch-app、open-url、restart-app は自動化対象のアプリを設定します。reinstall-app はその設定を消去します。ツールサーバーを再起動すると設定が失われるため、もう一度起動してください。
• 各ツールの説明には、そのツール固有のハードウェア制限（名前付きキー、gesture-custom の形状、ボタン、エッジスワイプ、タップ回数）が記載されています。利用制限のあるツールは、エラーに何も追加されず not supported on ios device を返します。解決方法はエラーではなく、以下の一覧に記載されています。

ハードウェアで利用できるツール

• 利用できるのは次のツールのみです：list-devices、launch-app、restart-app、reinstall-app、open-url、describe、screenshot、screenshot-diff、gesture-tap、gesture-swipe、gesture-custom、button（home、volumeUp、volumeDown、搭載モデルでは actionButton）、keyboard、await-ui-element、await-screen-idle、run-sequence、e2e ツール、stop-simulator-server、stop-all-simulator-servers（セッション終了）。その他のデバイスツールはすべて not supported on ios device を返します。
• 2 本指のジェスチャー、rotate、shake、paste、settings-permissions、画面録画、debugger-*、react-profiler-*、native-profiler-*、native-*、boot-device は利用できません。アプリ独自のズームや回転の UI はタップやドラッグで操作し、スマートフォンは手で動かし、keyboard で文字を入力し、スマートフォンの「設定」で権限を変更してください。デバッグ、プロファイリング、録画はシミュレーターで行ってください。
• gesture-swipe：durationMs はドラッグの速度を指定するもので、時間を指定するものではありません。momentum:false は終了時に 300 ms 静止するだけで、減衰は行いません。open-url で https を開くと Safari が起動し、リンクを所有するアプリでは開きません。bundleId を渡してください。