Wireless Debugging Widget

무선 디버깅 위젯

홈 화면에서 탭 한 번으로 무선 디버깅(Wi-Fi를 통한 ADB)을 켜고 끌 수 있습니다. 개발자 옵션을 탐색하거나 빠른 설정 메뉴를 열 필요 없이, 필요한 스위치를 필요한 위치에서 바로 사용할 수 있습니다.

빌드를 플래싱하고, 계측 테스트를 실행하고, 네트워크를 통해 IDE에 연결하는 등 하루 종일 여러 작업을 하는 Android 개발자를 위해 개발되었습니다. 무선 디버깅 위젯은 Wi-Fi를 통한 ADB를 반복적으로 켜고 끄는 번거로움을 없애고, 다섯 번의 탭으로 설정해야 했던 과정을 한 번의 탭으로 간소화합니다.

** 작동 방식 **

이 위젯은 Android의 adb_wifi_enabled 전역 설정을 읽고 씁니다. 필요한 권한이 부여되면 스위치를 탭하여 무선 디버깅을 즉시 켜고 끌 수 있습니다. 이는 개발자 옵션에서 수동으로 켜고 끄는 것과 동일한 효과를 홈 화면에서 바로 누릴 수 있습니다.

** 설정 **

무선 디버깅 위젯은 Android의 무선 디버깅 플래그가 보호된 시스템 설정이므로 한 번만 설정하면 됩니다. Google은 WRITE_SECURE_SETTINGS 권한을 보유한 앱에만 이 기능을 허용합니다. 이 권한은 일반 설치 대화 상자에서는 부여할 수 없으며, 컴퓨터에서 ADB를 통해 한 번만 부여해야 합니다.

앱 내 정보 화면에서 전체 설정 방법을 안내합니다.

1) 기기에서 개발자 옵션을 활성화합니다.

2) ADB가 설치된 컴퓨터에 기기를 연결하고 다음 명령어를 실행합니다.

adb devices

3) 출력에서 ​​기기 ID를 복사한 다음 다음 명령어를 실행합니다.

adb -s shell pm grant com.celestwatches.wirelessdebuggingwidget android.permission.WRITE_SECURE_SETTINGS

부분을 이전 단계에서 복사한 ID로 바꿉니다.

4) 위젯을 홈 화면에 추가합니다. 런처에서 지원하는 경우 한 번 탭하여 추가하고, 지원하지 않는 경우 길게 눌러 추가합니다.

두 명령어 모두 앱 내에도 표시되며, 한 번 탭하여 복사할 수 있는 버튼이 있습니다. 설정이 완료되면 위젯은 오프라인에서 작동하며, 계정, 클라우드 동기화, 데이터 수집이 필요하지 않습니다.

위젯이 탭에 반응하지 않으면 권한 부여 명령을 다시 실행하세요. Android는 WRITE_SECURE_SETTINGS 권한을 특정 설치에만 적용하므로 재설치, 시스템 업데이트 및 백업 복원 시 권한이 자동으로 취소될 수 있습니다. 권한 부여 명령을 다시 실행하면 위젯 기능이 즉시 복원됩니다.

참고로, 예시 명령은 순정 Android 및 대부분의 주요 기기에서 작동하지만, 일부 제조업체(샤오미, 삼성 등)는 Android 권한 시스템에 추가적인 제한을 두고 있습니다. 기기에서 명령이 오류를 반환하는 경우, 보조 개발자 토글을 활성화하거나 제조업체별 지침을 먼저 따라야 할 수 있습니다. 기기 모델과 "grant WRITE_SECURE_SETTINGS"를 함께 검색하면 정확한 절차를 찾을 수 있습니다.

**주요 기능**

- 홈 화면에서 한 번 탭으로 무선 디버깅을 켜고 끌 수 있습니다.

- 머티리얼 디자인 스타일의 스위치 그래픽으로 현재 상태를 한눈에 확인할 수 있습니다.

- 자동 라이트/다크 모드 지원: 시스템 테마에 맞춰 위젯이 자동으로 조정됩니다.

- 접근성: TalkBack과 완벽하게 통합되어 상태 안내를 제공합니다.

- 홈 화면 어디에나 배치 가능한 2x1 크기의 컴팩트한 위젯입니다.

- 앱에 설정 방법 및 필요한 ADB 명령어가 내장되어 있습니다.

- 권한이 부여되지 않은 경우 개발자 옵션으로 전환됩니다.

**요구 사항**

- Android 11(API 30) 이상 - 무선 디버깅은 Android 11에서 도입되었습니다.

- 필요한 시스템 권한을 부여하기 위한 일회성 ADB 설정

- 기기에서 개발자 옵션이 활성화되어 있어야 합니다.

**개인 정보 보호**

무선 디버깅 위젯은 어떠한 개인 정보도 수집, 전송 또는 저장하지 않습니다. 이 앱은 사용자 계정, 분석 기능, 광고 및 타사 SDK를 사용하지 않습니다. 네트워크 활동은 앱 내 "CELEST에서 더 보기" 섹션을 채우기 위한 주기적인 확인(최대 주 1회)뿐입니다. 이 확인 작업은 celest-watches.com에서 다른 CELEST 앱 목록을 가져와 로컬에 저장합니다.

**CELEST 소개**

CELEST는 구독료, 광고, 개인 정보 추적 없이 작고 기능에 집중된 Android 앱과 Wear OS 워치 페이스를 제작합니다. 각 제품은 한 가지 기능에 특화되어 있습니다. celest-watches.com을 방문하거나 Google Play에서 "CELEST"를 검색하여 자세한 내용을 확인하세요.