Android Stop App

概要

adb shell am force-stopを使用して、接続されたデバイス上で実行中のAndroidアプリを停止します。すべてのアプリプロセスをクリーンに終了し、メモリをクリアしながらアプリデータを保持します。

使用する場面

以下の場合にこのスキルを呼び出してください。ユーザーが:

• 「Androidアプリを停止する」と要求している
• 「アプリを終了したい」と望んでいる
• 「デバイス上のAndroidアプリを終了する」と言っている
• Androidアプリのシャットダウンまたはクローズについて言及している
• 新しいバージョンをデプロイする前に停止する必要がある

前提条件

• AndroidデバイスがUSBで接続されている
• USBデバッグが有効化されている
• ADBがインストールされている(brew install android-platform-tools)
• デバイスが認可されている
• アプリがデバイス上で実行中である

手順

1. Androidアプリディレクトリに移動します:

   cd path/to/android/app
   

2. stopスクリプトを実行します:

   ./stop-app.sh
   

3. スクリプトは以下を実行します:

   • adb shell am force-stopを使用してアプリを終了する
   • 成功を報告する

4. ユーザーに以下を通知します:

   • アプリが停止された
   • アプリが実行中でなくても呼び出しは安全
   • force-stopを使用してクリーンなシャットダウンを実行(killではない)

予想される出力

🛑 Stopping NoobTest on device...
✅ App stopped

動作原理

スクリプトは以下を使用します:

• adb shell am force-stop com.miso.noobtest

このAndroidフレームワークコマンドは:

• パッケージに関連するすべてのプロセスを停止する
• メモリからアプリをクリアする
• アプリデータと設定を保持する
• クリーンなシャットダウンを実行(緊急キルではない)

force-stop vs kill

force-stop (推奨):

• Androidフレームワークコマンド
• クリーンなシャットダウン
• アプリデータを保持
• 開発に安全

kill (推奨されない):

• OS レベルのシグナル
• 急激な終了
• リソースが不整合な状態のままの可能性
• force-stopが失敗した場合のみ使用

一般的な使用例

新しいバージョンをデプロイする前:

./stop-app.sh
./install-device.sh

再起動とのペアリング:

./stop-app.sh
# 設定変更を行う
./restart-app.sh

クリーンな状態でのテスト:

./stop-app.sh
# 必要に応じてアプリデータを手動でクリアする
adb shell pm clear com.miso.noobtest
# その後インストール

よくある問題

「no devices found」:

• USB接続を確認する
• USBデバッグが有効化されていることを確認する
• 認可を確認: adb devices
• 試す: adb kill-server && adb start-server

「adb: command not found」:

• Androidプラットフォームツールをインストール: brew install android-platform-tools
• PATHにadbが含まれていることを確認する

force-stop後もアプリが実行中:

• レアですが、以下で確認: adb shell pidof com.miso.noobtest
• まだ実行中の場合、デバイスを再起動する
• または使用: adb shell pm clear com.miso.noobtest (アプリデータも削除)

安全性

このスクリプトは繰り返し呼び出しても安全です:

• アプリが実行中でない場合でもエラーにならない
• クリーンなシャットダウン方法を使用
• ステータスを明確に報告
• アプリデータまたはインストールへのリスクなし

パッケージ名

スクリプトは特定のアプリのパッケージ名で設定されます(例: Firefly/NoobTestの場合はcom.miso.noobtest)。パッケージ名はbuild.gradle.ktsのapplicationIdで定義されます。

データ保持

force-stopは以下をクリアしません:

• アプリのインストール
• アプリデータ(SharedPreferences、データベース、ファイル)
• アプリの権限
• ユーザー設定

アプリの状態を完全にクリアするには、以下を使用します:

adb shell pm clear com.miso.noobtest

ただし、これは再インストールとセットアップが必要になります。