WorkBuddy로 위챗 미니 프로그램 만드는 법: 초보자 가이드

위챗 미니프로그램을 만들고 싶다면, 가장 먼저 이런 것들에 막힐 수 있어요. 위챗 개발자 도구, 프로젝트 디렉터리, AppID, 클라우드 개발 환경, 데이터베이스, 업로드, 백엔드 버전 관리까지.

이게 다 뭐지? 코드 한 줄도 안 써 봤는데 벌써 이런 기술적인 것들에 막혀 버렸네요.

괜찮아요. 코드를 한 번도 작성해 본 적이 없어도, 미니프로그램을 만들어 본 적이 없어도, AppID가 뭔지 몰라도, 이 글은 여러분을 위해 쓰였어요.

한 번의 오후에 만드는 경험

이 글을 읽고 나면 다음 방법을 알게 됩니다:

• 위챗 개발자 도구에 코드 불러오기 (AppID 등록 없이도 가능)
• 내 휴대폰에서 실행하기
• 친구에게 테스트용 QR 코드 보내기
• 심사 제출, 출시, 검색 가능 상태 만들기

먼저, 제가 만든 완성품을 볼게요.

괜찮아 보이죠? 시작해 볼게요.

I. 시작 10분 전

WorkBuddy를 열고, 전문가, 스킬 또는 커넥터 목록에서 "위챗 미니프로그램 개발자" 전문가를 찾아 소환하세요.

그리고 "미니프로그램 만들어 줘"라고만 하지 마세요.

1매일 습관 기록용 미니프로그램을 하나 만들고 싶어요. 혼자 쓰려고요.
2첫 번째로, 먼저 무엇을 알려드려야 할까요? 아직 코드는 작성하지 말고, 먼저 의논해요.

"매일 습관 기록"을 자신의 아이디어로 바꾸면 됩니다.

그러면 AI가 데이터 저장 방식, 1차 버전의 완성도, 사용할 개발 방식, 매일 알림 필요 여부, 습관 유형, 알림 시간 단위, 디자인 스타일 선호도 등을 물어보고, 마지막에는 분류 기준, 보관/삭제, 통계 주기까지 세부 조정을 요청할 거예요.

AI는 여러분이 생각하지 못했던 질문들을 정리해 주고 방향을 잡아 줍니다.

처음부터 완벽을 목표로 하지 마세요. 일단 1.0 버전을 만들게 한 다음, 기본 뼈대가 완성되면 천천히 조정하고 수정하면 됩니다. 방향이 정해졌다면, 이제 작업을 시작하게 하세요.

AI가 코드를 작성하는 동안, 위챗 개발자 도구를 설치할 수 있어요.

이건 위챗 공식 도구예요. 미니프로그램이 결국 이곳에서 실행되고, 미리보기되고, 업로드되기 때문이죠. 공식 다운로드 페이지에서 "위챗 개발자 도구"를 검색하고, 안정 버전(Stable Version)을 선택해 설치 안내를 따라 진행한 뒤, QR 코드 스캔으로 로그인하면 됩니다. 들어가면 이렇게 생겼어요:

몇 가지 주의할 점:

💡 첫 버전은 기능을 한두 개로 유지하세요. 기능이 많을수록 생성할 페이지가 늘어나고 오류가 나올 확률도 높아져요. 핵심부터 고치세요.

💡 모델을 HY3로 전환하고, 자동(auto)에 두지 마세요. 지금은 한정 기간 동안 무료로 무제한 사용할 수 있어요. (이 글을 읽는 시점에 프로모션이 아직 진행 중인지 백엔드에서 확인해 보세요.)

⚠️ 메뉴 이름이 제가 말한 것과 다를 수 있어요. 이런 소프트웨어 도구는 업데이트가 잦거든요. 문제가 생기면 스크린샷을 WorkBuddy에 던져 주세요. 어디를 클릭해야 할지 알려 줄 거예요.

코드가 완성되면 프로젝트 폴더 경로를 알려 줘요. 이 경로를 기억해 두세요. 다음 단계에서 필요해요. 보통 불러오기 방법도 함께 안내해 주는데, 안내가 없다면 "코드가 준비됐는데, 위챗 개발자 도구에 어떻게 불러와?"라고 물어보면 됩니다.

이제 준비물: 미니프로그램 코드 한 벌과 설치된 위챗 개발자 도구.

모든 준비가 끝났어요. 이제 반제품을 미리보기 할 시간입니다.

II. 반제품 확인하기

방금 설치한 위챗 개발자 도구를 열고, QR 코드 스캔으로 로그인한 뒤 + 버튼을 클릭하세요.

그다음 세 가지를 입력합니다:

1. 프로젝트 이름: 알아볼 수 있는 이름이면 아무거나 괜찮아요.
2. 디렉터리: 아까 단계에서 받은 주소를 붙여 넣으세요.
3. AppID: 빨간색으로 표시될 수 있는데, 괜찮아요. "테스트 계정"을 클릭하면 문제없이 진행됩니다.

백엔드 서비스는 "클라우드 서비스 사용 안 함"을 선택하세요. 생성을 클릭한 뒤 "신뢰하고 실행"을 클릭하면 도구가 자동으로 빌드를 시작해요.

⚠️ 정식 AppID로 전환해야 하는 경우: 위챗 클라우드 개발을 사용하거나, 업로드를 하거나, 다른 사람이 체험하게 하려면 이메일로 무료 계정을 하나 등록하세요. 6장에서 자세히 설명합니다.

⚠️ 그리고 등록 전에 카테고리를 신중하게 결정하세요. 미니게임과 기타 유형 중에서 선택해야 하는데, 나중에 변경할 수 없어요.

모든 것이 순조롭다면 도구에서 미니프로그램을 볼 수 있어요. 왼쪽에는 시뮬레이터, 오른쪽에는 코드가 표시됩니다.

이제 여러분은: 컴퓨터에서 실행되는 미니프로그램을 갖게 되었어요.

또는 화면 가득 빨간 오류 텍스트를 볼 수도 있어요. 당황하지 마세요. 고치기 쉽습니다.

III. 빨간 글씨 투성이? 작성자에게 고치게 하세요

첫 빌드에서 오류가 발생하는 것은 정상이에요.

해결 방법은 간단합니다. 작성한 쪽에서 고치게 하면 됩니다. 😂

구체적으로:

1. 위챗 개발자 도구에서 디버거(Debugger) 패널을 찾으면 모든 빨간 오류가 거기에 있어요.
2. 오류 메시지 전체를 복사하세요. 일부만 캡처하거나 요약해서 보내지 마세요.
3. WorkBuddy에 보내면 됩니다. 아무 말도 하지 않아도 AI가 알아서 고쳐 줘요.

분석이 끝나면 코드를 직접 고치거나 필요한 설정을 안내해 줄 거예요.

두 가지 주의할 점:

⚠️ 오류처럼 보여도 오류가 아닌 경우: 미니프로그램은 일부 웹 스타일 코드(특정 셀렉터나 호버 효과 등)를 지원하지 않아요. 컴퓨터에서 이상하게 보인다면 미니프로그램이 지원하지 않기 때문이에요. AI에게 "이 효과는 미니프로그램에서 지원되지 않으니 다른 방법으로 바꿔 줘"라고 말하면 됩니다.

⚠️ 또 하나는 "가짜" 오류: 수정 사항이 적용되지 않는 경우예요. AI를 의심하기 전에, 오른쪽 상단의 "일반 컴파일" 옆에 있는 "컴파일" 새로고침 버튼을 클릭하면 대부분 해결됩니다.

이제 여러분은: 하얀 화면이나 문제없이 잘 실행되는 미니프로그램을 갖게 되었어요.

컴퓨터 시뮬레이터에서는 잘 보이지만, 실제 휴대폰에서는 다를 수 있어요.

IV. PC에서는 잘 보이는데, 모바일에서는 다를 수 있어요

실제 휴대폰에서는 스타일이 어긋나거나 버튼이 클릭되지 않는 경우가 흔해요. 시뮬레이터에서 잘 작동해도요. 화면 크기도 다르고, 터치와 마우스도 다르니까요.

휴대폰에서 실행하려면 버튼 하나만 누르면 됩니다: 미리보기(Preview).

도구가 QR 코드를 생성해요. 위챗으로 스캔하면 휴대폰에서 미니프로그램이 열립니다.

여기서 사람들이 헷갈리는 부분이 있어요: 미리보기(Preview), 실기 테스트(Real Machine Test), 원격 디버깅(Remote Debugging) 모두 QR 코드를 생성하는데, 뭐가 다를까요?

⚠️ 미리보기를 최종 테스트로 사용하지 마세요. 미리보기는 그냥 빠르게 확인하는 용도일 뿐, 모든 것이 제대로 동작한다는 의미가 아니에요. 확인은 실기 테스트로 하세요.

⚠️ 한 가지 더: 개발 편의를 위해 도구에서는 일부 검증이 꺼져 있지만, 실제 기기에서는 여전히 활성화되어 있어요. PC에서는 작동해도 모바일에서는 실패할 수 있습니다.

이제 여러분은: 내 휴대폰에서 열리는 미니프로그램을 갖게 되었어요.

친구에게 코드를 보내고 싶어서 손이 근질근질할 거예요. 잠깐, 먼저 다섯 가지 점검을 실행하세요. 안 그러면 버그 투성이일 수 있어요! 😂

V. 친구에게 버그를 테스트하게 하지 마세요

5분이면 충분해요. 다섯 가지를 직접 확인해 보세요:

1. 추가: 새 항목을 추가하면 목록에 나타나나요?
2. 상태: 완료/미완료 토글이 잘 작동하나요?
3. 재진입: 미니프로그램을 종료하고 다시 열었을 때, 방금 추가한 데이터가 그대로 있나요?
4. 삭제: 항목을 삭제하면 새로고침 후에도 사라진 상태가 유지되나요?
5. 빈 값: 아무것도 입력하지 않고 추가를 누르면 안내 메시지가 표시되고 빈 기록이 생성되지 않아야 해요.

3번과 5번은 특별히 테스트하지 않으면 놓치기 쉬워요.

항목 하나를 고친 후에는 다섯 가지를 모두 다시 실행하세요. A를 고치면 B가 깨지는 경우가 많아요.

⚠️ 다섯 가지를 모두 통과했다고 해서 크래시가 없다는 뜻은 아니에요. 이건 다듬는 과정이며, 이상한 문제를 발견하거나 새로운 아이디어가 떠오르기도 해요. 결국 만족스러운 버전에 도달하게 될 겁니다.

이제 여러분은: 마음에 드는 다듬어진 미니프로그램을 갖게 되었어요.

이제 친구에게 보내기 위해 마지막으로 필요한 것이 하나 있어요: 정식 신분(계정)입니다.

VI. 친구가 스캔할 코드 보내기

다른 사람이 스캔할 수 있게 하려면 정식 AppID가 필요해요. 등록 방법:

1. 위챗 공식 계정 플랫폼을 열고 등록 절차를 따르세요. 유형은 여러 가지가 있어요: 공식 계정, 미니프로그램, 미니게임. 미니프로그램을 선택하세요. ⚠️ 잘못 선택하면 변경할 수 없으니, 삭제하고 다시 시작해야 해요.
2. 사용하지 않는 이메일을 사용하세요. 이메일을 입력하고, 활성화를 클릭하고, 받은 편지함으로 전송된 인증 코드를 입력하고, 비밀번호를 설정하세요.

1. 주체(Subject)를 선택하세요. 개인용이라면 "개인(Individual)"을 선택하세요. 신분증 인증과 위챗 스캔이 필요하며 무료예요.
2. 백엔드에 들어가 개발 관리(Development Management)에서 AppID를 찾으세요. "wx"로 시작해요. 복사하세요.

AppID를 확보했다면, WorkBuddy에 이렇게 보내세요:

1프로젝트의 AppID를 내 AppID로 변경해 줘: [wx로 시작하는 문자열]

그런 다음 위챗 개발자 도구로 돌아가 오른쪽 상단의 "업로드"를 클릭하세요.

버전 번호와 설명을 요청할 거예요. 처음에는 0.0.1을 사용하세요. 업로드가 끝나면 위챗 백엔드의 버전 관리(Version Management) 페이지로 이동하세요. 버전이 보일 텐데, 아래쪽 화살표를 클릭하면 "체험판(Trial Version)"을 찾을 수 있어요. 설정하면 체험판 QR 코드가 생성됩니다.

이제 친구들에게 미니프로그램을 자랑할 수 있어요! 출시하거나 정식 심사를 통과하지 않아도 친구들은 QR 코드 스캔만으로 사용할 수 있습니다.

두 가지 주의할 점:

첫째, 업로드는 출시가 아니에요. 업로드는 개발 버전을 백엔드에 올려 놓는 것뿐이에요. 아직 검색되지 않으며, 코드를 가진 사람만 접근할 수 있어요.

둘째, 체험판에는 만료 기간이 있어요. 보통 7일이에요. 다시 업로드하면 새 코드를 얻을 수 있어요. 데모용이나 지인 몇 명과 공유하기에는 딱 좋아요.

⚠️ 많은 사람에게는 이것으로 충분해요. 개인용이거나 친구들끼리만 쓴다면 체험판으로 충분합니다. 인증과 비안(ICP)은 이후 장에서 설명할게요.

이제 여러분은: 친구에게 보낼 체험판 QR 코드를 갖게 되었어요.

진짜 미니프로그램을 만들었네요. 그런데 친구가 데이터를 추가한 뒤 앱을 닫으면 데이터가 사라져요. 데이터를 저장하려면 어떻게 해야 할까요?

VII. 앱을 닫아도 데이터를 잃지 않기

아직 데이터가 어디에 저장되는지 해결하지 못했어요.

데이터가 휴대폰 로컬에만 존재한다면, 휴대폰을 바꾸거나 데이터를 공유하고 싶을 때 사라져요. 백엔드가 필요해요. 직접 백엔드를 구축하려면 서버, 데이터베이스, 도메인, HTTPS, 비안(ICP)까지 필요하죠. 번거로움을 피하고 클라우드 개발(Cloud Development)을 사용하세요. 데이터베이스와 로직이 클라우드에 있고, 미니프로그램이 직접 호출합니다.

1. 도구 상단의 "클라우드 개발"을 클릭 → 활성화 → 환경 ID(Environment ID) 확인

활성화를 클릭하면 월 19.9위안의 요금이 표시될 수 있어요. 잠깐, 기다려 보세요. 자동으로 무료 개발 환경으로 안내될 거예요.

1. 환경 ID를 복사해 WorkBuddy에 보내 globalData.env ID를 설정하게 하세요.

1. 클라우드 개발 콘솔 → 데이터베이스 → categories / habits / checkins 같은 컬렉션을 생성하세요. 권한은 "생성자만 읽기/쓰기"로 설정하세요. WorkBuddy가 어떤 컬렉션을 생성해야 하는지 알려 줄 거예요.

1. cloudfunctions/login을 마우스 오른쪽 버튼으로 클릭 → 업로드 및 배포: 클라우드 종속성 설치를 선택하세요. 이렇게 하면 클라우드 함수가 필요한 패키지를 찾을 수 있어요.

팁: 프로젝트에서 cloudfunctions를 찾을 수 없다면 가져온 폴더가 잘못된 거예요. 상위 폴더로 변경하세요.

이제 데이터 저장 준비가 끝났어요. 프로젝트를 다시 불러오면 AppID와 클라우드 환경 ID를 요청할 거예요.

⚠️ 테스트 계정으로는 안 됩니다. 정식 AppID가 필요해요.

⚠️ 클라우드 개발은 신규 사용자에게 프로모션이 있는 경우도 있지만 기간 한정이에요.

데이터를 저장하는 버전을 다시 가져오고, AppID를 붙여 넣고, 백엔드 서비스로 "위챗 클라우드 개발"을 선택하세요. 이제 데이터가 연결되었습니다.

데이터 저장이 완료되었어요. 낯선 사람이 여러분을 찾거나 상업적으로 사용하려면, 진짜 도전이 시작됩니다.

VIII. 낯선 사람이 나를 찾을 수 있게 하기

체험판을 통과하는 것과 정식 심사를 통과하는 것은 달라요.

먼저 여섯 가지 자체 점검을 실행하세요:

1. AppID가 정식인가요? 테스트 계정은 출시할 수 없어요.
2. 모든 페이지를 클릭해 보세요. 하얀 화면이나 크래시가 없어야 해요.
3. 서버 도메인을 설정하세요. 앱이 외부 데이터를 가져온다면 해당 도메인을 백엔드(개발 → 개발 설정)에 등록해야 해요. HTTPS와 WSS만 허용되며, 도메인은 비안(ICP)이 완료되어야 해요. IP는 허용되지 않아요.
4. 개발자 도구에서 "요청 도메인 검증 안 함..." 옵션을 해제하세요. 이 옵션은 도구에서만 동작하며, 실제 기기에서는 여전히 검증해요. 끄고 다시 테스트하세요.
5. 사용자 개인정보 보호 가이드를 작성하세요. 앱이 아바타, 위치, 연락처를 읽는다면 반드시 신고해야 해요. 그렇지 않으면 해당 API가 비활성화됩니다. 사용자 정보를 다루지 않는다면 건너뛰어도 돼요.
6. 백엔드에서 이름, 아바타, 소개, 카테고리를 완성하세요. 카테고리를 잘못 선택하는 것이 심사 거절의 흔한 이유예요.

💡 클라우드 개발을 사용하거나 인터넷을 사용하지 않는다면 3번과 4번은 건너뛰세요.

🔴 제가 준비한 내용이에요. WorkBuddy에 그대로 보내기만 하면 됩니다:

1위챗 미니프로그램 심사를 제출하려고 해. 이 프로젝트를 아래 항목들에 맞춰 점검해 줘.
2고칠 수 있는 건 고치고, 내가 직접 입력해야 할 것은 알려 줘.
3project.config.json의 appid가 테스트 계정인지 확인해 줘.
4app.json의 모든 페이지 경로를 나열해서 하얀 화면이 있는지 확인할 수 있게 해 줘.
5프로젝트에서 wx.request, wx.uploadFile, wx.downloadFile, wx.connectSocket을 검색해 줘.
6모든 도메인을 추출해서 네 가지 카테고리로 그룹화해 줘.
7https/wss로 시작하지 않거나 IP를 사용하는 항목을 표시해서 백엔드에서 설정할 수 있게 해 줘.
8project.config.json의 urlCheck가 false면 true로 바꿔 줘.
9사용자 정보 API(아바타, 위치, 연락처 등)를 검색해서 어떤 파일/줄에서 사용하는지 나열해 줘.
10개인정보 보호 가이드를 작성할 때 사용할 거야.
11남아 있는 console.log 디버깅 코드가 있는지 확인해 줘.
12마지막으로 요약 표를 만들어 줘: 점검 항목, 현재 상태, 다음 단계.

⚠️ 2번을 건너뛰지 마세요. 정식 심사는 완성된 제품을 요구해요. "기능 불완전"으로 거절되는 경우가 흔합니다.

그리고 제출 전에 넘어야 할 4개의 관문이 있어요:

1️⃣ 미니프로그램 정보

• 이름: 알아보기 쉬운 이름 (예: "습관 트래커"). 개인 계정은 "공식"이나 "위챗"을 사용할 수 없어요.
• 아이콘: 1024x1024 PNG.
• 소개: 기능을 설명하는 한 문장.
• 서비스 범위: "도구 > 효율성" 또는 "생활 서비스"를 선택하세요.

2️⃣ 카테고리

개인 계정은 제한이 있어요. 추천: 도구 > 효율성 또는 메모장. 카테고리에 따라 사용할 수 있는 API가 결정됩니다.

3️⃣ 비안(ICP)

2024년부터 모든 미니프로그램은 ICP 비안이 필요해요. 신분증 사진과 얼굴 인증이 필요하며 영업일 기준 1~3일이 소요됩니다.

4️⃣ 위챗 인증 (선택이지만 권장)

개인 계정도 연 300위안으로 인증할 수 있어요. 비용을 지불하고 싶지 않다면 건너뛰어도 돼요. 출시에는 지장이 없지만, 검색은 되지 않아요.

흔한 거절 사유: 의료/금융 자격증명 부족, 라이브 스트리밍 권한 부족, 기능 불완전. 심사는 보통 1~7일 걸립니다.

보이시죠? 해냈어요

AI에게 말을 걸자 코드가 나타났어요.

경로를 입력하자 페이지가 표시되었어요.

빨간 글씨를 보내자 스스로 고쳐졌어요.

QR 코드를 스캔하자 휴대폰에서 실행되었어요.

업로드를 클릭하자 친구들이 스캔할 수 있었어요.

시작부터 끝까지, 코딩 지식은 전혀 필요 없었어요.

오늘 밤 딱 하나만 하면 돼요: 위챗 개발자 도구를 설치하는 것. 10분이면 충분해요.

설치가 끝나면 뭔가 만들어 보고 싶어서 몸이 근질거릴 거예요. 그때쯤이면 이미 시작한 겁니다.

미니프로그램을 만들고 싶지만 아직 시작하지 못한 사람이 있다면, 이 글을 보내 주세요. 주말을 절약해 줄 거예요.

저는 Song Song이에요. 앞으로도 유용한 콘텐츠를 계속 공유할게요.