이 페이지에서는 워치 페이스 형식으로 빌드된 시계 화면을 디버그하는 방법을 설명합니다. 시계 화면 XML을 검사하고 런타임 오류를 식별하는 방법도 설명합니다.
유효한 워치 페이스 형식 문서 확인
워치 페이스 형식에는 게시된 XSD를 준수하는 잘 구성된 XML이 필요하므로 시계 화면의 유효성을 확인하고 오류를 식별할 수 있습니다.
XML 유효성 검사 도구를 사용하여 빌드 프로세스 중에 문제를 식별합니다. 이 도구는 샘플 시계 화면의 빌드 프로세스에 통합되어 있습니다.
시계 화면을 만드는 도구를 빌드하는 경우 도구에서 XSD를 사용하여 XML 유효성 검사를 실행해야 합니다.
유효성 검사 도구를 수동으로 실행하는 예는 다음과 같습니다.
java -jar wff-validator.jar 2 ~/MyWatchface/res/raw/watchface.xml
watchface.xml 문서에 오류가 있으면 height가 hight로 잘못 입력된 이 경우와 같이 오류가 표시됩니다.
INFO: DWF Validation Application Version 1.0. Maximum Supported Format Version #2
SEVERE: [Line 41:Column 53]: cvc-complex-type.3.2.2: Attribute 'hight' is not allowed to appear in element 'PartDraw'.
INFO: ❌ FAILED : watchface.xml is NOT valid against watch face format version #1
유효성 검사기는 수정해야 하는 요소의 위치(41번 줄, 53번 열)를 식별합니다.
XML 검사기 도구를 가져오고 사용하기 위해 빌드하는 방법을 알아보세요.
런타임 오류 식별
XML 자체가 유효하다고 해서 모든 잠재적 문제를 포착하기에 충분하지는 않습니다.
예를 들어 XML이 존재하지 않는 글꼴 또는 드로어블 리소스를 참조하거나 표현식에서 숫자 값을 생성해야 하지만 문자열이 생성될 수 있습니다.
이러한 유형의 문제의 경우 Android 스튜디오에서 또는 ADB를 통해 logcat을 사용하면 더 자세한 정보를 얻을 수 있습니다.
'런타임'을 기준으로 필터링하면 시계 화면에 영향을 미치는 심각한 문제와 심각하지 않은 문제가 모두 표시됩니다. 예를 들어 다음과 같이 존재하지 않는 HourHand의 리소스를 지정하는 경우
E Invalid resource ID 0x00000000.
E FATAL EXCEPTION: main
Process: com.google.wear.watchface.runtime, PID: 29115 android.content.res.Resources$NotFoundException: Resource ID #0x0
잘못된 색상 테마를 사용하려고 할 때도 다음과 같은 오류가 발생합니다.
W color has wrong type of source:CONFIGURATION.myTheeeme.2[OBJECT:]
E Cannot parse theme color. Using theme color WHITE