클로드를 활용한 나만의 어메이즈핏 워치페이스 만들기3편 (사각형 워치페이스 기준)

1편과 2편을 따라하다 보면 크고 작은 오류를 만날 수 있어요. 사실 저도 만드는 내내 이것저것 부딪혔는데, 원인을 하나씩 찾아보니 대부분 몇 가지 패턴으로 정리되더라고요. 여기 정리해둔 표를 먼저 확인하시면 시간을 많이 아끼실 수 있을 거예요.

목차

1. "스크립트를 실행할 수 없다"는 PowerShell 오류
2. cd 명령어가 "경로를 찾을 수 없다"고 할 때
3. 이미지(바늘·눈금 등)가 워치에서 안 보일 때
4. 분명히 파일을 고쳤는데 워치 화면이 그대로일 때
5. 눈금이 다이아몬드처럼 찌그러져 보일 때
6. 서브다이얼 테두리가 안 그려지고 꽉 채워질 때
7. 한눈에 보는 오류 요약표
8. 마치며

1. "스크립트를 실행할 수 없다"는 PowerShell 오류

증상: zeus preview를 입력했는데 아래처럼 빨간 글씨로 UnauthorizedAccess, PSSecurityException 같은 에러가 나요.

원인: Windows의 PowerShell은 보안 정책상 외부 스크립트 실행을 기본적으로 막아둬요. zeus 명령어도 내부적으로 스크립트라서 막히는 거예요.

해결법: PowerShell 대신 일반 명령 프롬프트(cmd)를 쓰면 이 제한이 없어요. 키보드에서 Windows키 + R을 누르고 cmd라고 입력한 다음 Enter를 누르면 확실하게 진짜 명령 프롬프트가 열려요.

2. cd 명령어가 "경로를 찾을 수 없다"고 할 때

증상: cd Downloads\my-watchface 같은 명령어를 쳤는데 "지정된 경로를 찾을 수 없습니다"라고 나와요.

원인: 지금 명령창이 있는 위치(예: C:\Windows\System32) 기준으로 상대경로를 찾다 보니, 실제 폴더 위치와 안 맞는 경우가 많아요.

해결법: /d 옵션과 함께 전체 경로를 정확히 써주세요.

cd /d C:\Users\내계정이름\Downloads\my-watchface

정확한 경로를 모르겠다면, 파일 탐색기에서 그 폴더를 열어놓고 주소창을 클릭하면 전체 경로가 나와요. 그걸 그대로 복사해서 쓰면 확실해요.

3. 이미지(바늘·눈금 등)가 워치에서 안 보일 때

증상: 글자와 서브다이얼 테두리는 잘 나오는데, 시침·분침·눈금·아이콘 같은 이미지 요소가 하나도 안 보여요.

원인: 거의 대부분 이미지 파일이 잘못된 폴더에 있는 경우예요. Zepp OS 프로젝트는 이미지가 assets 폴더 바로 아래가 아니라, assets/[기기이름 폴더]/ 안에 들어가야 인식돼요.

해결법: 파일 탐색기로 assets 폴더를 열어서, 이미지 파일들이 기기 이름으로 된 하위 폴더(예: assets/390x450-amazfit-active-2-square/) 안에 들어있는지 확인하세요. 바깥에 있다면 그 하위 폴더 안으로 옮겨주면 해결돼요.

4. 분명히 파일을 고쳤는데 워치 화면이 그대로일 때

증상: 코드도 이미지도 다 새 걸로 바꿨는데, 워치에 스캔해서 설치해봐도 예전 모습 그대로예요.

원인: 빌드 결과물이 어딘가에 캐시(임시 저장)되어 있어서, 내용은 바뀌었는데 버전 정보가 그대로라 시스템이 "이전과 같은 앱"으로 인식하고 재사용하는 경우가 있어요.

해결법 (아래 순서대로 시도해보세요):

1. zeus prune 명령어로 빌드 캐시 지우기
2. app.json의 version 안 code와 name 숫자를 하나씩 올리기 (예: 1 → 2, "1.0.0" → "1.0.1")
3. 워치에서 기존에 설치된 테스트용 워치페이스가 있다면 삭제 후 재설치
4. 그래도 안 되면 완전히 새 폴더에서 zeus create로 프로젝트를 새로 만들어서 재시도

5. 눈금이 다이아몬드처럼 찌그러져 보일 때

증상: 똑바로 세워진 눈금(예: 6시, 12시 방향)은 멀쩡한데, 비스듬한 각도의 눈금만 다이아몬드/마름모 모양으로 찌그러져 보여요.

원인: 일부 기기는 이미지를 비스듬한 각도로 회전시킬 때 매끄럽게 처리하지 못하고 비뚤게 그리는 경우가 있어요 (기기 자체의 렌더링 한계).

해결법: 두 가지 방법이 있어요.

• 방법 A: 각 각도별로 이미 회전된 모양의 이미지를 미리 여러 장 만들어두고, 그때그때 회전 없이 그대로 배치하기
• 방법 B (추천): 애초에 눈금을 원이 아니라 사각형 테두리를 따라가는 배치로 바꾸기 — 이러면 눈금은 위/아래 변에서는 세로로, 좌/우 변에서는 가로로만 놓이기 때문에 항상 0도 또는 90도 회전만 쓰게 되고, 문제가 되는 비스듬한 회전 자체가 필요 없어져요.

6. 서브다이얼 테두리가 안 그려지고 꽉 채워질 때

증상: 서브다이얼을 동그란 테두리 선으로 그리고 싶었는데, 안이 꽉 찬 원으로 나와요.

원인: 원을 그리는 기본 도형(CIRCLE) 위젯은 항상 안이 채워진 상태로만 그려져요. 테두리만 그리는 옵션이 따로 없어요.

해결법: 원 테두리 전용 도형(ARC)을 360도로 그리면 돼요. 시작 각도 0, 끝 각도 360으로 설정하면 완전한 원 모양 테두리가 만들어져요.

한눈에 보는 오류 요약표

증상	원인	해결법
PowerShell 보안 오류	스크립트 실행 정책 제한	cmd(명령 프롬프트) 사용
cd 경로를 못 찾음	상대경로 위치 불일치	cd /d 전체경로 사용
이미지가 안 보임	assets 하위 기기 폴더 밖에 위치	기기 이름 하위 폴더 안으로 이동
수정해도 화면이 그대로	빌드 캐시/버전 미갱신	zeus prune + 버전 번호 올리기
눈금이 찌그러짐	비스듬한 회전 렌더링 한계	사각 트랙 배치로 전환
원이 꽉 채워짐	CIRCLE은 항상 채움	ARC(0~360도)로 대체

마치며

이렇게 3편에 걸쳐서 클로드로 아마즈핏 워치페이스를 직접 만드는 전체 과정을 정리해봤어요. 처음엔 막막했지만, 막히는 부분마다 화면을 캡처해서 클로드에게 보여주고 "이게 왜 이러는지, 어떻게 고치면 되는지" 물어보면서 하나씩 해결해나가니 결국 원하는 모습으로 완성할 수 있었어요. 그리고 이러한 작업을 통해 완성을 하지 못했더라도 기존에 zeep 명령프로그램과 zeep 개발자 모드를 켜놓으면 다음에 다시  만들 수 있어서 다시 도전해보면 좋을 듯 합니다.

마지막으로 제가 만든 클로드 및 파일 환경과 컴퓨텨 환경에 따라 다 다른 환경으로 되어 있기 때문에 밀부 오류나 스크립트 및 코드가 환경에 따라 다를 수 있으니 클로드에게 자신의 코드와 설명들을 상세하게하여 착오 없이 진행해주세요.

코드를 몰라도 스크린샷과 말로 설명하는 것만으로 이 정도까지 만들 수 있다는 게 개인적으로 가장 신기했던 부분이에요. 여러분도 한번 도전해보세요!

👉 1편 다시 보기 · 2편 다시 보기