VIA 키맵 저장·불러오기 — JSON 백업과 적용 확인

이 안내는 VIA에서 키보드가 이미 인식된 뒤의 파일 보관 작업입니다. 기본 연결·지원 조건은 VIA 키보드 설정에서 확인하세요. 확장자가 JSON이라고 모두 같은 곳에 넣는 파일은 아닙니다.

제조사 자료실에서 받은 정의 파일이 내 사용자 설정까지 보관하는 것은 아닙니다. 반대로 사용자 키맵 파일을 Design에 넣어 기기 인식을 해결하려고 하지 마세요. 파일명이나 확장자만으로 판단하지 말고 어디서 받은 파일인지 확인합니다.

1. 현재 선택된 키보드의 모델·배열·펌웨어와 사용하는 레이어를 기록합니다. 같은 이름의 다른 기기를 잘못 선택하지 않았는지 확인하세요.
2. Configure(구성)의 Save+Load에서 Save Current Layout에 해당하는 Save를 선택합니다. 언어·버전에 따라 메뉴 표기는 달라질 수 있습니다.
3. 저장 위치와 파일명을 정합니다. 날짜·모델·배열을 알아볼 수 있게 구분하되 파일 확장자는 유지합니다.
4. 저장 후 해당 위치에 JSON 파일이 실제 생겼는지 확인합니다. 저장창을 취소했다면 백업 파일을 만든 것으로 생각하지 마세요.

공식 앱 소스의 제안 파일명은 .layout.json으로 끝납니다. 이전 백업을 곧바로 덮어쓰지 말고 현재 상태도 구별해 보관하세요. 파일을 안전하게 확인할 수 있다면 모델 이름과 layers 같은 키맵 데이터가 있는지 대조하되, 적용을 강제로 통과시키려고 식별값을 수정하지 않습니다.

공식 Save+Load 소스는 이름·기기 식별값, layers·macros·encoders를 저장하도록 되어 있습니다. 실제 포함 데이터와 기능 지원은 키보드·펌웨어·앱 상태에 따라 확인해야 합니다.

이 파일을 펌웨어 전체나 모든 설정의 복사본으로 취급하지 마세요. 조명·제조사 전용 옵션까지 전부 복구된다고 보장할 수 없으며, 기기 정의 파일을 따로 쓰는 모델은 그 공식 파일과 모델 안내도 구분해 보관해야 합니다. 펌웨어를 바꾸기 위한 백업 절차로 일반화하지 않습니다.

1. 현재 설정도 새로운 파일로 저장합니다. 어떤 백업이 어느 시점의 설정인지 구분하세요.
2. 백업을 만든 같은 지원 키보드를 선택하고 모델·배열·펌웨어 조건을 대조합니다. 같은 제품명만으로 호환된다고 판단하지 않습니다.
3. Save+Load의 Load Saved Layout에서 사용자 레이아웃 JSON을 선택합니다. 제조사 기기 정의 JSON을 선택하는 단계가 아닙니다.
4. 오류가 표시되면 파일과 조건을 확인하고 진행을 멈춥니다. 성공 표시가 나더라도 아래 입력 확인을 따로 수행합니다.

Load는 파일 내용을 보기만 하는 버튼이 아닙니다. 공식 소스에는 선택한 기기의 키맵과 지원되는 매크로·인코더 설정에 값을 쓰는 호출이 있습니다. 현재 설정을 보존한 뒤, 적용할 의도가 있는 백업만 선택하세요.

이 항목들은 공식 소스에 있는 검사 예시이며 모든 호환성 문제를 잡아주는 목록은 아닙니다. 오류가 없었다는 사실만으로 다른 모델·펌웨어에 완전히 호환된다고 판단하지 마세요. 정확한 파일·기기 상태를 확인하기 어렵다면 기존 설정을 유지하고 제조사 지원을 확인합니다.

• 기본 키: 빈 입력창에서 바꾼 키와 원래 중요 키가 의도한 값을 보내는지 확인합니다.
• 레이어: 사용하는 각 레이어와 들어가고 나오는 전환 키를 확인합니다.
• 매크로·인코더: 지원하는 항목만 시험하며 실제 계정·비밀번호를 시험용 입력으로 쓰지 않습니다.
• 사용 환경: 키 테스트 표시와 실제 앱의 입력·단축키 결과를 구분해 확인합니다.

현재 설정과 다르면 어느 키·레이어부터 차이가 나는지 기록하세요. 이전 파일로 다시 적용하려는 경우에도 같은 조건 확인과 입력 점검이 필요합니다. 이 절차의 근거는 공식 문서·소스이며, 모든 기기의 실제 복원 성공을 보장하는 시험 결과는 아닙니다.