README.md 업데이트: 전체 프로젝트 설명 및 사용법 개선

2025-12-31 09:23:29 +09:00
parent 8c09380943
commit 8d8f28d177
1 changed files with 155 additions and 24 deletions
--- a/README.md
+++ b/README.md
@ -1,53 +1,184 @@
-# U10 Pro 디지털 사이니지 세팅 자동화
+# T-Order 태블릿 세팅 자동화 시스템

-T오더에서 사용하던 태블릿(U10 Pro)을 디지털 사이니지 대용으로 전환하기 위한 자동화 세팅 도구입니다.
+T-Order에서 사용하던 태블릿(ITAB X40L Plus)을 디지털 사이니지 또는 특수 용도로 전환하기 위한 자동화 세팅 도구입니다.
+
+## 📋 개요
+
+이 도구는 여러 대의 태블릿을 연속으로 설정할 수 있는 자동화 시스템으로, 각 기기를 연결하면 자동으로 WiFi 설정, 불필요한 앱 제거, 시스템 최적화, 필수 앱 설치 및 설정을 수행합니다.
+
+## 🎯 주요 기능
+
+- **연속 다중 기기 지원**: 한 대 완료 후 다음 기기 자동 대기
+- **모델 자동 검증**: 호환 모델만 처리 (ITAB_X40L_Plus)
+- **WiFi 자동 연결**: 지정된 네트워크에 자동 접속
+- **앱 정리 자동화**: T-Order, YouTube 등 불필요한 앱 일괄 제거
+- **디지털 사이니지 최적화**: 화면 상시 켜짐, 절전 비활성화 등
+- **필수 앱 자동 설치**: Synology Photos, MacroDroid 설치 및 권한 설정
+- **배경화면 설정 지원**: 사용자 확인 방식으로 안정성 보장

 ## 📁 폴더 구조

 ```
-u10pro_setting/
-├── setup.bat          # 메인 자동화 스크립트
+platform-tools/
+├── setup.bat          # 메인 자동화 스크립트 (연속 다중 기기 지원)
 ├── spec_chk.bat       # 기기 사양 확인 스크립트
-├── README.md          # 프로젝트 설명서
+├── README.md          # 프로젝트 설명서 (본 문서)
 ├── sdk/               # Android SDK Platform Tools
-│   ├── adb.exe        # (별도 다운로드 필요)
-│   ├── fastboot.exe   # (별도 다운로드 필요)
+│   ├── adb.exe
+│   ├── fastboot.exe
 │   └── ...
-└── data/              # 태블릿에 삽입될 데이터
-    ├── macrodroid.apk
-    ├── macrodroid.mdr
-    ├── photos.apk
-    └── wallpaper.jpg
+└── data/              # 태블릿에 전송될 데이터
+    ├── macrodroid.apk # MacroDroid 앱 설치 파일
+    ├── macrodroid.mdr # MacroDroid 매크로 프로필
+    ├── photos.apk     # Synology Photos 앱 설치 파일
+    └── wallpaper.jpg  # 배경화면 이미지
 ```

 ## 🚀 사용 방법

-### 사전 준비
+### 1. 사전 준비

-1. **SDK 다운로드**: [Android SDK Platform Tools](https://developer.android.com/studio/releases/platform-tools) 다운로드 후 `sdk/` 폴더에 압축 해제
-2. **USB 디버깅 활성화**: 태블릿에서 개발자 옵션 > USB 디버깅 활성화
-2. **USB 케이블 연결**: 컴퓨터와 태블릿을 USB 케이블로 연결
-3. **ADB 인증 허용**: 태블릿에서 "이 컴퓨터에서 USB 디버깅 허용" 팝업 승인
+1. **SDK 설치 확인**: `sdk/` 폴더에 Android Platform Tools가 있는지 확인
+   - 없을 경우: [Android SDK Platform Tools](https://developer.android.com/studio/releases/platform-tools) 다운로드 후 압축 해제
+   
+2. **필수 파일 준비**: `data/` 폴더에 다음 파일들이 있는지 확인
+   - `macrodroid.apk`, `photos.apk`: 앱 설치 파일
+   - `macrodroid.mdr`: 매크로 설정 파일
+   - `wallpaper.jpg`: 배경화면 이미지

-### 기기 사양 확인
+3. **태블릿 설정**:
+   - 설정 > 태블릿 정보 > 빌드 번호 7회 탭하여 개발자 모드 활성화
+   - 설정 > 개발자 옵션 > USB 디버깅 활성화
+
+### 2. 기기 사양 확인 (선택사항)

 ```powershell
 .\spec_chk.bat
 ```

-태블릿의 모델명, OS 버전, 센서 탑재 여부 등을 확인합니다.
+태블릿의 모델명, OS 버전, 센서 탑재 여부 등을 확인할 수 있습니다.

-### 자동 세팅 실행
+### 3. 자동 세팅 실행

 ```powershell
 .\setup.bat
 ```

-실행 후 기기를 연결하면 자동으로 다음 작업이 수행됩니다:
+스크립트 실행 후:
+1. 태블릿을 USB로 연결
+2. 태블릿에서 "USB 디버깅 허용" 팝업 승인
+3. 자동으로 작업이 진행됨
+4. 사용자 확인이 필요한 단계에서 안내 메시지 표시
+5. 작업 완료 후 기기 연결 해제하면 자동으로 다음 기기 대기

-1. **WiFi 설정** - 지정된 네트워크에 자동 연결
-2. **앱 정리** - T-Order, YouTube 등 불필요한 앱 제거
-3. **시스템 최적화** - 애니메이션 비활성화, 화면 꺼짐 방지
+### 4. 작업 흐름
+
+#### STEP 1: 네트워크 설정 (WiFi)
+- WiFi 활성화
+- 지정된 SSID로 자동 연결
+
+#### STEP 2: 앱 정리
+- T-Order 관련 앱 자동 검색 및 제거
+- YouTube, Google Keep, TeamViewer 등 불필요한 앱 제거
+
+#### STEP 3: 시스템 최적화 (디지털 사이니지 모드)
+- 애니메이션 효과 전체 비활성화
+- 화면 상시 켜짐 설정 (타임아웃 무한대)
+- 화면 밝기 최대 고정
+- 자동 회전 활성화
+- 터치 사운드/햅틱 피드백 비활성화
+- 알림 숨김 모드 활성화
+- 자동 업데이트 비활성화
+- 절전 모드 비활성화
+- USB 디버깅 유지 설정
+
+#### STEP 4: 필수 앱 설치 및 배경화면
+- Synology Photos 앱 설치 (미설치 시)
+- MacroDroid 앱 설치 (미설치 시)
+- 배경화면 설정 앱 실행
+  - **사용자 확인**: 태블릿에서 앱 선택 및 배경화면 설정 완료 후 키 입력
+
+#### STEP 5: MacroDroid 권한 설정
+- 시스템 설정 쓰기 권한
+- 다른 앱 위에 표시 권한
+- 사용 기록 접근 권한
+- 방해 금지 모드 접근 권한
+- 알림 리스너 서비스 권한
+- 접근성 서비스 활성화
+
+#### STEP 6: MacroDroid 매크로 프로필 전송
+- 매크로 설정 파일을 Download 폴더로 전송
+
+#### 작업 완료
+- 기기 연결 해제 감지
+- 3초 후 자동으로 새로운 기기 대기 상태로 전환
+- **Ctrl + C**로 언제든지 전체 작업 종료 가능
+
+## ⚙️ 설정 변경
+
+`setup.bat` 파일 상단의 설정 영역에서 다음 값들을 수정할 수 있습니다:
+
+```bat
+:: --- [설정 영역] ---
+set "DEBUG_MODE=OFF"                        # 디버그 모드 (ON/OFF)
+set "SSID=fg"                               # WiFi SSID
+set "PW=Fg9576861!"                         # WiFi 비밀번호
+set "PKG_MD=com.arlosoft.macrodroid"        # MacroDroid 패키지명
+set "PKG_PHOTOS=com.synology.projectkailash" # Photos 패키지명
+set "TARGET_MODEL=ITAB_X40L_Plus"           # 대상 기기 모델
+```
+
+## 🔧 문제 해결
+
+### ADB를 찾을 수 없음
+- `sdk/` 폴더에 `adb.exe`가 있는지 확인
+- Android SDK Platform Tools 다운로드 필요
+
+### 기기가 인식되지 않음
+- USB 디버깅이 활성화되어 있는지 확인
+- USB 케이블이 데이터 전송을 지원하는지 확인
+- 태블릿에서 "USB 디버깅 허용" 팝업 승인 필요
+
+### 호환되지 않는 모델 오류
+- 현재 `ITAB_X40L_Plus` 모델만 지원
+- 다른 모델 사용 시 `TARGET_MODEL` 설정 변경 필요
+
+### 배경화면 설정이 스킵됨
+- 앱 실행 후 3초 대기 시간이 자동으로 추가됨
+- 사용자가 배경화면 앱을 선택하고 설정 완료 후 키 입력 필요
+
+## 📝 참고사항
+
+- 작업 중 태블릿 연결을 해제하지 마세요
+- 네트워크 설정은 WiFi만 지원합니다
+- 모든 설정은 ADB 명령어로 수행되므로 인터넷 연결이 필요하지 않습니다
+- 디버그 모드를 ON으로 설정하면 모든 명령어 출력을 확인할 수 있습니다
+
+## 📜 라이선스
+
+이 프로젝트는 내부 사용을 위한 도구입니다.
+
+## 🙋 문의
+
+문제가 발생하거나 개선 사항이 있으면 이슈를 등록해 주세요.
+- USB 디버깅 유지 설정
+
+#### STEP 4: 필수 앱 설치 및 배경화면
+- Synology Photos 앱 설치 (미설치 시)
+- MacroDroid 앱 설치 (미설치 시)
+- 배경화면 설정 앱 실행
+  - **사용자 확인**: 태블릿에서 앱 선택 및 배경화면 설정 완료 후 키 입력
+
+#### STEP 5: MacroDroid 권한 설정
+- 시스템 설정 쓰기 권한
+- 다른 앱 위에 표시 권한
+- 사용 기록 접근 권한
+- 방해 금지 모드 접근 권한
+- 알림 리스너 서비스 권한
+- 접근성 서비스 활성화
+
+#### STEP 6: MacroDroid 매크로 프로필 전송
+- 매크로 설정 파일을 Download 폴더로 전송
 4. **앱 설치** - MacroDroid, Synology Photos 설치
 5. **배경화면 설정** - 지정된 이미지로 배경화면 변경
 6. **권한 자동 부여** - MacroDroid 권한 자동 설정