문제 해결과
업데이트 안내.

어떤 문제가 있나요?

Anki 가져오기가 멈춰요

앱 버전, 저장 공간, 미디어 처리 상태를 확인합니다.

가져오기 진단 →

한자 확장을 만들 수 없어요

ZIP 풀기, 실행 파일, PDF 선택과 오류 문구를 확인합니다.

오류 확인 →

업데이트하고 싶어요

학습 기록을 지키는 순서와 현재 버전 변경점을 확인합니다.

업데이트 가이드 →

파일이 받아지지 않거나 열리지 않아요.

공식 배포 페이지에서 받은 APKG의 파일명과 SHA-256을 아래 값과 대조하세요.

버전v1.3.0
파일JLPT-MAX-Deck-1.3.0.apkg
크기약 0.90GB
SHA-2569d2667bac17f781603ba3f2a92e496ea6ba9dad607de4058470d35cb0e2c64d3

Anki 가져오기가 멈춰요.

앱, 저장 공간, 다운로드 파일을 순서대로 확인하세요.

  1. 기기에 맞는 Anki 앱인지 확인합니다.

    데스크톱은 Anki, iPhone·iPad는 AnkiMobile, Android는 AnkiDroid를 사용하세요. 이름이 비슷한 다른 앱은 APKG와 호환되지 않을 수 있습니다.

  2. 미사용 미디어를 삭제해 저장 공간을 확보합니다.

    앱을 최신 안정 버전으로 업데이트하고, 여러 기기를 쓴다면 미디어 동기화를 먼저 끝내세요. 데스크톱 Anki에서 도구 → 미디어 검사를 열어 미사용 파일 목록을 확인한 뒤 삭제합니다. 삭제된 파일은 휴지통으로 이동하므로 필요한 파일이 없는지 확인한 뒤 휴지통을 비워야 실제 여유 공간이 생깁니다.

  3. 손상된 파일을 다시 받습니다.

    SHA-256이 다르면 기존 다운로드를 버리고 안정적인 네트워크에서 다시 받습니다.

처리 중 강제 종료하지 마세요.

18,437개 미디어를 처리하므로 환경에 따라 시간이 걸립니다. 완료 메시지가 나오기 전까지 앱을 유지하세요.

한자 확장을 만들 수 없어요.

기본 덱에 일상무따가 없는 것은 정상입니다. 한자 확장이 필요하다면 처음부터 따라가는 만들기 가이드를 먼저 확인하세요.

  1. 더블클릭할 실행 파일이 보이지 않아요.

    ZIP 미리보기 안이 아니라 압축을 푼 새 폴더를 여세요. Windows에는 Windows에서 한자 확장 만들기.cmd, macOS에는 Mac에서 한자 확장 만들기.command가 있습니다.

  2. 필요한 프로그램을 받지 못했다고 나와요.

    처음 실행할 때만 빌드 도구와 Python을 자동으로 받습니다. 인터넷 연결을 확인한 뒤 ZIP을 새 폴더에 다시 풀고 더블클릭 실행 파일을 다시 여세요.

  3. PDF hash 또는 page count 오류가 나요.

    공식 자료 페이지에서 정상적으로 받은 상·하권 소책자 PDF 2개와 순서를 확인하세요. 다시 저장·병합·최적화한 PDF나 미리보기 파일은 지원되지 않습니다.

  4. alignment 오류가 나요.

    같은 v1.3.0의 빌더와 지원 PDF가 맞지 않거나 1권·2권 선택 순서가 바뀌었을 수 있습니다. 현재 빌더 ZIP을 새 폴더에 다시 풀고 실행하세요.

  5. PDF 선택창을 취소했어요.

    아무 파일도 바뀌지 않습니다. 실행 파일을 다시 더블클릭하고 처음부터 선택하면 됩니다.

  6. 완성 파일을 다시 만들고 싶어요.

    더블클릭 실행 파일을 다시 열면 기존 결과를 지우고 새로 만들지 묻습니다. 다시 만들기를 선택한 뒤 PDF 두 개를 다시 고르세요.

실패하면 빌더 폴더의 kanji-builder.log를 확인하세요.

공개 issue에 전체 로그나 PDF를 올리지 말고 개인 경로를 지운 오류 문구만 적어 주세요.

한자 확장 만들기 전체 가이드 →

새 버전으로 업데이트하고 싶어요.

먼저 학습 기록을 보존하는 업데이트 순서를 확인한 뒤, 아래에서 현재 버전의 변경점과 별도 교정이 있는지 확인하세요.

  1. v1.3.0최신

    한자 읽기·쓰기와 획순 연습을 추가하고 가나 보조 카드를 정리했으며, 카드 읽기·음성·예문·오류 제보를 다듬었습니다.

    • 한자 2,337자를 읽기와 쓰기로 나누고 직접 쓰기·전체 지우기·정답 자형·획순 재생을 추가했습니다. 기존 읽기 카드의 ID와 학습 기록은 유지하고 쓰기 카드는 새 학습 항목으로 시작합니다.
    • 읽기 카드에 음독·훈독별 실제 단어와 현재 어휘에 없는 공식 상용한자 읽기를 함께 보여 주고, 비슷한 한자의 뜻과 읽기를 비교하는 힌트를 추가했습니다.
    • 앞면에서 히라가나만 묻던 가나 보조 카드를 없앴습니다. 기존 사용자는 빈 카드 도구로 남은 카드만 정리하며, 보조 카드의 일정·기록은 원래 한자 카드로 옮기지 않습니다.
    • 한자 읽기 정보와 단어 고저 악센트의 모바일 가독성, 긴 루비·괄호 읽기 간격, 카드 앞뒤 머리글과 글꼴 적용 안정성을 높였습니다.
    • 디코딩된 음성의 앞쪽 무음을 건너뛰고, v1.2.1 예문 묶음에서 빠졌던 한 묶음 안 여러 표현의 예문도 한 영역으로 모았습니다. iPhone·iPad는 v1.3.0부터 무음 모드 재생을 기본으로 바꾸고, 예전처럼 다른 앱 음악과 함께 재생하려면 사용자가 옵션을 켜도록 했습니다.
    • AnkiDroid 구형 학습 화면 안내를 추가하고, 오류 제보는 익명을 기본으로 유지하면서 답장을 원하는 경우에만 동의 후 연락처를 입력하도록 했습니다.
    • 掛かる·沸騰·細かい·冷やす·断る·改札·定員·遠慮의 뜻과 예문 연결, 15개 어휘의 예문 묶음을 다시 검토했습니다.
    • 届ける·幾つ·種·通っている·噛み癖·条件·設定·了承·打診과 이미지 한자 4건, iOS 재생 제보 6건을 교정하거나 해결했습니다. 기각 32건은 이유를 공개하고, 가나 보조 카드 제보 81건은 해결로 다시 분류했습니다.
    • 사용 통계를 켠 경우 업데이트 공지 이벤트의 재전송·중복 합치기와 버전별 활동·익명 설치 수 추정치를 추가했습니다. 사용 통계를 새로 켜지는 않습니다.
    • public 기본 APKG는 13,903노트·19,921카드이고, 한자 빌더가 읽기·쓰기 합계 4,674노트·4,674카드를 별도로 만듭니다.
    • 두 APKG를 합친 전체는 18,577노트·24,595카드이며 기존 공통 카드 22,258개의 ID·일정·복습 기록을 유지합니다.

    업데이트 안내기존 사용자는 모든 기기를 동기화하거나 백업한 뒤 v1.3.0 기본 덱을 기존 덱 위에 가져오세요. 학습 진행 상태 가져오기는 끄고, 기존 노트 업데이트는 항상, 노트 유형 병합은 켜기를 선택합니다. 한자 확장을 사용한다면 v1.3.0 빌더와 지원 PDF 2개로 한자 APKG를 다시 만들어 가져오세요. 일반 APKG 가져오기는 기존 한자 카드의 덱 위치를 바꾸지 않으므로 한자::읽기::상권·하권은 비어 있을 수 있습니다. 새 폴더 구조를 쓰려면 카드 탐색기에서 기존 일상무따 상권·하권 카드를 읽기 상권·하권으로 직접 옮기세요. 이어서 Anki의 빈 카드 도구에서 JLPT MAX덱 어휘 / 어휘(가나 보조)만 골라 삭제하고 모든 기기에서 전체 동기화하세요. 카드 탐색기의 노트 삭제는 사용하지 마세요.

  2. v1.2.1

    단어 고저 악센트의 끝 방향을 표시하고 뜻·예문 순서를 맞췄으며, 글꼴·후리가나와 익명 통계의 일부 동작을 고쳤습니다.

    • 어휘 102개의 예문을 카드에 보이는 뜻 순서대로 다시 배치했습니다.
    • 슬래시로 나뉜 뜻이 여러 개인 어휘 651개는 뜻 묶음별 예문을 별도 영역으로 나눠 보여 줍니다.
    • 단어 고저 악센트 선 끝에 화살표를 추가해 단어 뒤에서도 높게 이어지는지 낮게 떨어지는지 보여 줍니다.
    • 긴 단어의 좁은 고저 악센트 칸은 히라가나 폭을 조정해 선과 글자가 덜 겹칩니다.
    • Mac Anki에서 한자 버튼과 사전 버튼의 크기·정렬을 맞추고 기본 열기·닫기 동작을 복원했습니다.
    • 긴 후리가나가 본문을 밀지 않게 하고 활용·학습·익명 통계의 펼치기 화살표를 같은 모양으로 맞췄습니다.
    • 일본어 글꼴 전환 때 카드가 깜빡이거나 고저표 위치가 튀는 현상을 줄였습니다.
    • 기존 익명 통계에서 좁은 화면의 가로 밀림을 막고, 공유를 다시 켜도 같은 설치를 중복 집계하지 않습니다.
    • 제보된 猛 후리가나, 縁 뜻 간격과 木曜日 정답·해설 번호를 교정했습니다.
    • 노트 16,240개·카드 22,402개와 GUID·학습 기록·스케줄 호환성을 유지했습니다.

    업데이트 안내v1.2.0 사용자는 동기화하거나 백업한 뒤 v1.2.1 기본 덱을 기존 덱 위에 가져오세요. 학습 진행 상태 가져오기는 끄고, 기존 노트 업데이트는 새 버전일 때, 노트 유형 병합은 켜기를 선택합니다. 기존 v1.2.0 한자 확장은 그대로 쓸 수 있습니다. v1.1.x와 v1.0.x에서 바로 업데이트한다면 v1.2.0의 필드와 템플릿도 적용해야 하므로 기존 노트 업데이트를 항상으로 선택합니다. v1.2.1 시험판은 정식판 알림을 받을 수 없으므로 정식 APKG를 직접 받아 가져와야 합니다.

  3. v1.2.0

    모든 어휘·예문에 고저 악센트를 추가하고 뜻 249개와 예문 182개를 보강했으며, 카드 설정·다의어 문맥 힌트·모바일 팝업을 개선했습니다.

    • 어휘 6,018개와 예문 7,065개에 고저 악센트 선을 추가하고 설정에서 언제든 끌 수 있게 했습니다.
    • 학습자 뜻 표시 249개를 다듬고 예문 182개를 추가했으며 신고된 실전 문제·문장·품사·발음과 とお 조수사 문제 표기도 교정했습니다.
    • 일본어 글꼴을 명조·고딕 중에서 고를 수 있고, 후리가나·해석·자동재생·고저 악센트 설정을 한 패널에서 조절합니다.
    • 앞면만으로 뜻을 구분하기 어려운 そば·開く·避ける·紅葉·なる 5개 표제어의 10개 카드에 짧은 빈칸 문맥을 추가했습니다.
    • 좁은 모바일 화면에서 오류 제보·사용 통계 팝업의 제목과 동작 버튼이 잘리지 않도록 보정했습니다.
    • 새 카드를 복습 카드 사이에 섞어 보여 주도록 기본 preset을 바꿨습니다.
    • 노트 16,240개·카드 22,402개와 GUID·학습 기록·스케줄 호환성을 유지했습니다.

    업데이트 안내v1.1.x와 v1.0.x 사용자는 모두 동기화하거나 백업한 뒤 v1.2.0 기본 덱을 기존 덱 위에 가져오세요. 학습 진행 상태 가져오기는 끄고, 기존 노트 업데이트는 항상, 노트 유형 병합은 켜기를 선택한 뒤 전체 동기화합니다. v1.0.x는 v1.1.x의 뜻·예문 변경도 함께 적용됩니다. 한자 확장도 v1.2.0 빌더로 다시 만들면 Windows Anki 야간 모드용 투명 SVG 렌더링과 새 일본어 글꼴, 최신 연결 어휘 표시가 함께 적용됩니다. 교체된 예전 음성이 미사용으로 남으면 모든 기기의 미디어 동기화를 끝낸 뒤 데스크톱 Anki의 도구 → 미디어 검사에서 목록을 확인해 삭제하고 다시 동기화하세요.

  4. v1.1.1

    뜻 묶음과 예문 표시를 더 분명하게 하고 보충 예문 100개를 추가했으며, 모바일 설정 저장과 iPhone·iPad 음성 재생을 보강했습니다.

    • 쉼표로 묶인 같은 의미의 표현은 가운데점(·)으로, 슬래시로 나뉜 독립 의미는 슬래시(/)로 표시해 뜻 구조를 더 분명하게 보여 줍니다.
    • 예문 1·2 같은 번호 대신 각 문장이 대응하는 뜻 표현을 칩으로 표시하고, 구성 요소별 보충 예문 100개와 음성을 추가해 검토 예문을 6,883개로 늘렸습니다.
    • iPhone·iPad에서 쿠키 저장이 거부돼 후리가나·해석·자동재생·배속 설정이 초기화되거나 익명 통계 상태가 유지되지 않던 문제를 수정했습니다.
    • 설정과 익명 통계 상태를 쿠키와 localStorage에 함께 저장하고, 한쪽만 남아 있어도 다른 쪽을 자동으로 복구합니다.
    • 기존 Android 사용자의 쿠키 값을 우선해 그대로 이어받으며, AnkiDroid의 학습 화면 로컬 스토리지 설정을 켜면 localStorage도 앱 재시작 뒤 유지됩니다.
    • iPhone·iPad에서는 ambient 오디오 세션을 요청한 뒤 HTML 오디오 요소를 직접 재생하고, Android와 데스크톱은 기존 Web Audio 경로를 유지합니다.
    • 모든 카드 답면의 새 버전 안내에서 업데이트 가이드, 7일간 숨기기와 해당 버전 알림 다시 보지 않기를 제공합니다.
    • 노트 16,240개·카드 22,402개와 안정 ID를 유지해 기존 학습 기록과 호환됩니다. 전체 미디어는 보충 예문 음성을 포함해 18,267개입니다.

    업데이트 안내1.1.0 사용자는 동기화 또는 백업 후 v1.1.1 기본 덱을 기존 덱 위에 가져오세요. 학습 진행 상태 가져오기는 끄고, 기존 노트 업데이트는 새 버전일 때, 노트 유형 병합은 켜기를 선택합니다. 항상은 1.0.x → 1.1.x처럼 가운데 숫자가 바뀌는 마이너 버전 업데이트에서만 선택합니다. 기존 한자 확장은 다시 만들 필요가 없습니다.

  5. v1.1.0

    어휘 뜻 386개와 의미별 예문을 교정하고 카드 설정·재생 속도·인앱 오류 제보를 보강했습니다.

    • 어휘 386개의 학습자 표시 뜻을 실제 쓰임이 더 잘 드러나도록 교정했습니다.
    • 뜻이 여러 개인 단어는 의미별 예문을 다시 맞춰 배치하고 검토 예문을 6,783개로 늘렸습니다.
    • AnkiMobile과 AnkiDroid에서만, 답안 화면 10회 뒤 명시적으로 동의한 경우에 한해 익명 사용 통계를 공유할 수 있습니다.
    • 통계에는 무작위 설치 ID, 모바일 환경, JLPT MAX 버전, 학습한 세부 덱과 날짜별 답안 확인 누적 횟수만 포함됩니다.
    • 모든 플랫폼의 답안 화면에서 내용·표시·음성 문제를 현재 카드 식별 정보와 함께 직접 제보할 수 있습니다.
    • 후리가나·해석·자동재생을 하나의 설정 메뉴로 모으고 0.8·1·1.2·1.5배 재생 속도를 추가했습니다.
    • 카드 설정과 통계 상태를 WebView 쿠키에 저장해 Android 앱 재시작으로 카드 포트가 바뀌어도 유지하며, 기기에는 오늘과 직전 학습일 최대 이틀치만 남깁니다.
    • 사용 통계 설정에서 언제든 공유를 끌 수 있으며, 끄면 설치 ID와 아직 전송하지 않은 기록을 즉시 삭제하고 이후 전송을 중단합니다.
    • 어휘 답안에서 한자 정보와 네이버 사전 링크를 단어 아래의 작은 도구로 묶고, 한자 정보를 간결한 행으로 표시합니다.
    • Android 야간 모드에서 일상무따 한자의 이미지 자형이 어둡게 보이던 문제를 수정했습니다.
    • AIVIS 장음 처리와 남아 있던 문맥·표식 발음 오류를 보정했습니다.
    • 실전 문제 GUID와 노트·카드 안정 ID, 덱 구조를 1.0.3과 동일하게 유지했습니다.

    업데이트 안내1.0.3 사용자는 동기화 또는 백업 후 v1.1.0 기본 덱을 기존 덱 위에 가져오세요. 학습 진행 상태 가져오기는 끄고, 기존 노트 업데이트는 반드시 항상, 노트 유형 병합은 켜기를 선택합니다. 새 버전일 때로 두면 기존 뜻·예문이 갱신되지 않습니다. 직접 편집한 노트 필드가 있다면 먼저 백업하세요. Android에서 한자 확장을 야간 모드로 사용한다면 v1.1.0 빌더로 다시 만드는 것을 권장합니다.

  6. v1.0.3

    빠져 있던 독립 의미를 보강하고 뜻·예문·정답 표시, 복습 화면과 모바일 음악 동시 재생을 개선했습니다.

    • 어휘 208개의 학습용 뜻을 실제 쓰임이 더 분명하게 드러나도록 고쳤습니다.
    • 158개 단어에 빠져 있던 독립 의미 165개를 보강했습니다. 예를 들어 上がる에는 ‘실내로 들어가다’와 ‘비가 그치다’, 打ち込む에는 ‘데이터를 입력하다’를 추가했습니다.
    • 50개 단어의 뜻 표현도 다듬었습니다. 예를 들어 司会는 ‘사회(회의·행사 진행)’, 克明은 ‘세세하고 꼼꼼하다’로 더 분명하게 표시합니다.
    • 모바일 카드 음성을 혼합 재생 방식으로 바꿔, 다른 앱의 음악을 들으면서 복습해도 음악이 줄어들거나 멈추지 않게 했습니다.
    • 예문 한국어를 따로 가리는 해석 켬/끔 버튼을 추가하고, 상단 컨트롤 정렬과 한자 정보 글리프 넘침을 바로잡았습니다.
    • 기본 덱의 노트·카드 ID와 덱 구조는 그대로 유지했습니다.

    업데이트 안내1.0.2 사용자는 동기화 또는 백업 후 v1.0.3 기본 덱을 기존 덱 위에 가져오세요. 학습 진행 상태 가져오기는 끄고, 기존 노트 업데이트와 노트 유형 병합은 켭니다. 기존 한자 확장도 계속 쓸 수 있지만 연결 어휘의 새 뜻까지 반영하려면 v1.0.3 빌더로 다시 만드세요.

  7. v1.0.2

    예문 후리가나 표시와 새 버전 안내를 추가하고 iPhone·iPad 조작과 한자 확장 만들기를 개선했습니다.

    • 어휘·음성·실전 문제 정답 화면에서 예문 후리가나를 켜고 끌 수 있습니다.
    • 카드 하단에서 현재 버전과 새 버전 공개 여부를 확인할 수 있습니다.
    • iPhone·iPad에서 음성 재생과 카드 안의 펼치기·설정 버튼이 안정적으로 반응하도록 보완했습니다.
    • 일상무따 한자 확장은 명령어 입력 없이 실행 파일 더블클릭과 PDF 선택으로 만들 수 있습니다.

    업데이트 안내1.0.1 사용자는 동기화 또는 백업 후 v1.0.2 기본 덱을 가져오세요. 학습 진행 상태 가져오기는 끄고, 기존 노트 업데이트와 노트 유형 병합은 켭니다. 기존 한자 확장은 다시 만들 필요가 없습니다.

  8. v1.0.1

    실전 문제의 JLPT 급수 귀속과 음성 카드 앞면을 바로잡았습니다.

    • 실전 문제 637개의 급수 귀속을 출처 섹션 기준으로 다시 판정했습니다.
    • 공식 문제 유형 범위에 맞춰 N1 표기 덱을 제거했습니다.
    • 음성 카드 앞면의 다시 듣기 버튼을 복구했습니다.

    업데이트 안내1.0.0 사용자는 동기화 또는 백업 후 JLPT MAX덱::종합 실전만 삭제하고 1.0.1 기본 덱을 가져오세요. 종합 실전 학습 기록만 초기화됩니다.

  9. v1.0.0

    JLPT MAX 기본 덱과 선택형 일상무따 한자 확장을 공개했습니다.

    • 어휘·음성·실전 문제·참조표가 포함된 기본 덱을 처음 공개했습니다.
    • 지원 PDF 2개로 개인용 일상무따 한자 확장을 만드는 빌더를 함께 배포했습니다.
    • iPhone·iPad의 자동재생 설정 터치 동작을 수정했습니다.

    업데이트 안내현재는 1.0.3 사용을 권장합니다. 이미 가져왔다면 먼저 위 1.0.1 교정 절차를 적용한 뒤 1.0.3으로 업데이트하세요.

자주 묻는 질문

기본 덱에는 무엇이 들어 있나요?
어휘, 음성, 실전 문제, 참조표가 들어 있습니다. 일상무따 한자 2,337개는 별도 선택 확장으로 추가할 수 있습니다.
한자 빌더에 PDF를 업로드하나요?
아닙니다. 빌더는 사용자 컴퓨터에서만 실행되며 PDF·이미지·생성 APKG를 외부로 전송하지 않습니다. 처음 실행할 때 빌드 도구와 Python을 받을 때만 프로그램 배포 서버와 패키지 저장소에 접속합니다.
AnkiWeb 사이트에서 APKG를 바로 가져올 수 있나요?
아닙니다. Desktop 또는 공식 모바일 앱에 먼저 가져온 뒤 AnkiWeb로 동기화하세요.

오류를 제보하고 싶어요.

카드 내용·표시·음성 문제는 해당 카드 답안 아래의 오류 제보를 사용하세요. 설치·다운로드·한자 빌더 문제는 GitHub 양식에 버전, 운영체제, Anki 버전, 실행 단계와 비민감 오류 문구를 적어 주세요.

첨부하면 안 되는 것

출판사 PDF, 책 본문·페이지 이미지, 기본 덱/한자 확장 APKG, 개인 Anki 컬렉션, 실명이나 홈 폴더가 드러나는 전체 경로는 올리지 마세요.