deploy

# Deploy Canvas Android Apps Install and deploy Canvas Android apps to connected devices or emulators. ## Deploy Location All deployment commands must be run from the repository root (`canvas-android/`), not the `apps/` directory. ## Check Connected Devices Before deploying, always check for connected devices or emulators: ```bash adb devices -l ``` If no devices are connected, start an emulator first. ## Install to Device Install an app to a connected device or emulator: ```bash # Install Student app ./gradle/gradlew -p apps :student:installDevDebug # Install Teacher app ./gradle/gradlew -p apps :teacher:installDevDebug # Install Parent app ./gradle/gradlew -p apps :parent:installDevDebug ``` ## Launch App After installation, launch the app using monkey: ```bash # Launch Student app adb shell monkey -p com.instructure.candroid -c android.intent.category.LAUNCHER 1 # Launch Teacher app adb shell monkey -p com.instructure.teacher -c android.intent.category.LAUNCHER 1 # Launch Parent app adb shell monkey -p com.instructure.parentapp -c android.intent.category.LAUNCHER 1 ``` ## Package Names - **Student**: `com.instructure.candroid` - **Teacher**: `com.instructure.teacher` - **Parent**: `com.instructure.parentapp` ## Target Specific Device If multiple devices are connected, target a specific device: ```bash # Install to specific device using Gradle ./gradle/gradlew -p apps :student:installDevDebug -Pandroid.injected.device.serial=emulator-5554 # Or use adb with -s flag adb -s emulator-5554 shell monkey -p com.instructure.candroid -c android.intent.category.LAUNCHER 1 ``` ## Common ADB Commands ### View Logs ```bash # View logs for Student app adb logcat | grep "candroid" # View logs for Teacher app adb logcat | grep "teacher" ``` ### Clear App Data ```bash # Clear Student app data adb shell pm clear com.instructure.candroid # Clear Teacher app data adb shell pm clear com.instructure.teacher # Clear Parent app data adb shell pm clear com.instructure.parentapp ``` ### Uninstall Apps ```bash # Uninstall Student app adb uninstall com.instructure.candroid # Uninstall Teacher app adb uninstall com.instructure.teacher # Uninstall Parent app adb uninstall com.instructure.parentapp ``` ## Examples Install and launch Student app: ```bash ./gradle/gradlew -p apps :student:installDevDebug adb shell monkey -p com.instructure.candroid -c android.intent.category.LAUNCHER 1 ``` Reinstall Teacher app (clear data first): ```bash adb shell pm clear com.instructure.teacher ./gradle/gradlew -p apps :teacher:installDevDebug adb shell monkey -p com.instructure.teacher -c android.intent.category.LAUNCHER 1 ```