From 8d8f28d177f365e0843b3f628995594e5139371f Mon Sep 17 00:00:00 2001 From: KWON Date: Wed, 31 Dec 2025 09:23:29 +0900 Subject: [PATCH] =?UTF-8?q?README.md=20=EC=97=85=EB=8D=B0=EC=9D=B4?= =?UTF-8?q?=ED=8A=B8:=20=EC=A0=84=EC=B2=B4=20=ED=94=84=EB=A1=9C=EC=A0=9D?= =?UTF-8?q?=ED=8A=B8=20=EC=84=A4=EB=AA=85=20=EB=B0=8F=20=EC=82=AC=EC=9A=A9?= =?UTF-8?q?=EB=B2=95=20=EA=B0=9C=EC=84=A0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 179 ++++++++++++++++++++++++++++++++++++++++++++++-------- 1 file changed, 155 insertions(+), 24 deletions(-) diff --git a/README.md b/README.md index 47cfd33..215cb27 100644 --- 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 권한 자동 설정