94 lines
2.2 KiB
Markdown
94 lines
2.2 KiB
Markdown
# Android Setup Guide
|
|
|
|
## Option 1: Use Physical Android Device (Recommended)
|
|
|
|
### Steps:
|
|
|
|
1. **Enable Developer Options on your Android device:**
|
|
- Go to Settings > About Phone
|
|
- Tap "Build Number" 7 times
|
|
- Go back to Settings > Developer Options
|
|
- Enable "USB Debugging"
|
|
|
|
2. **Connect device via USB:**
|
|
```bash
|
|
# Check if device is detected
|
|
adb devices
|
|
```
|
|
|
|
3. **Run the app:**
|
|
```bash
|
|
cd flutter_siab_app
|
|
flutter run
|
|
```
|
|
|
|
## Option 2: Use Android Emulator
|
|
|
|
### Install Android Studio:
|
|
|
|
1. Download Android Studio: https://developer.android.com/studio
|
|
|
|
2. Install Android SDK and create an emulator:
|
|
- Open Android Studio
|
|
- Tools > Device Manager
|
|
- Create Virtual Device
|
|
- Choose a device (e.g., Pixel 5)
|
|
- Download a system image (API 30+ recommended)
|
|
- Finish setup
|
|
|
|
3. **Start the emulator:**
|
|
```bash
|
|
# List available emulators
|
|
flutter emulators
|
|
|
|
# Launch emulator (replace with your emulator name)
|
|
flutter emulators --launch <emulator_id>
|
|
```
|
|
|
|
4. **Run the app:**
|
|
```bash
|
|
cd flutter_siab_app
|
|
flutter run
|
|
```
|
|
|
|
## Option 3: Build APK and Install Manually
|
|
|
|
If you can't use USB debugging, build an APK:
|
|
|
|
```bash
|
|
cd flutter_siab_app
|
|
flutter build apk --release
|
|
```
|
|
|
|
The APK will be at: `build/app/outputs/flutter-apk/app-release.apk`
|
|
|
|
Transfer to your Android device and install it.
|
|
|
|
## Troubleshooting
|
|
|
|
### "No devices found"
|
|
- Ensure USB debugging is enabled
|
|
- Try different USB cable/port
|
|
- Run `adb devices` to verify connection
|
|
- On Linux, you may need to add udev rules
|
|
|
|
### "Permission denied"
|
|
- Check USB debugging authorization on device
|
|
- Try `adb kill-server && adb start-server`
|
|
|
|
### Bluetooth not working on emulator
|
|
- Physical devices are recommended for Bluetooth testing
|
|
- Some emulators don't support Bluetooth BLE
|
|
- Use a real Android device for best results
|
|
|
|
## Required Permissions
|
|
|
|
The app needs these permissions (already configured):
|
|
- Bluetooth
|
|
- Bluetooth Admin
|
|
- Bluetooth Scan
|
|
- Bluetooth Connect
|
|
- Location (required for BLE scanning on Android 12+)
|
|
|
|
Make sure to grant all permissions when the app requests them.
|