appsok/README.md

34 lines
1.1 KiB
Markdown

# AppSok
Jenkins Android artifact를 Mac에서 내려받고, USB로 연결된 Android 기기에 ADB로 설치하기 위한 Flutter macOS 앱입니다.
## Scope
- Jenkins job/build/artifact 조회
- 사용자별 Jenkins API token 저장
- Android device 목록 조회
- APK 다운로드 및 `adb install -r`
- `adb logcat` 콘솔 뷰어
- `appsok://` 딥링크 기반 설치 진입점
## Current Scaffold
- `lib/src/features/builds`: build/artifact 목록 화면
- `lib/src/features/devices`: ADB device 화면
- `lib/src/features/console`: logcat 콘솔 화면
- `lib/src/features/settings`: Jenkins/ADB 설정 화면
- `lib/src/services`: Jenkins, Keychain, ADB 서비스 골격
- `lib/src/models`: Jenkins build와 ADB device 모델
## Development
```bash
flutter pub get
flutter run -d macos
```
## macOS Notes
- Jenkins 호출에는 macOS network client entitlement가 필요합니다.
- ADB 실행과 USB device 접근은 배포 방식에 따라 sandbox 정책 검토가 필요합니다.
- Jenkins token은 앱 번들에 넣지 않고 macOS Keychain에 사용자별로 저장하는 방향을 기본값으로 둡니다.