Publish Lab Notes
사용과 지원 안내
배포 실습 노트는 메모 작성, 검색, JSON 백업을 확인하기 위한 샘플 앱입니다. 공개 설치 경로는 플랫폼별 배포 상태에서 확인할 수 있습니다.
기본 사용
- Web 버전은 Web에서 실행을 열고, 설치형 앱이나 확장 프로그램은 설치 후 실행합니다.
- 새 메모를 만들고 제목과 본문을 입력한 뒤 저장합니다. 확장 프로그램은 팝업을 닫기 전에 저장하세요.
- 저장한 메모를 선택해 수정하거나 검색합니다. 삭제할 때는 대상을 확인하세요.
- 확장 프로그램의 현재 페이지 저장 기능은 일반
http또는https페이지에서 사용합니다. 버튼을 누르면 활성 탭의 제목과 URL을 읽어 이 브라우저에 메모로 저장합니다. 브라우저 설정 화면 같은 내부 페이지는 저장할 수 없습니다.
메모는 사용 중인 기기와 앱/브라우저 저장 공간에 남습니다. 같은 기기의 Web 버전과 확장 프로그램도 별도 저장 공간을 사용합니다. 처리하는 데이터와 사용 범위는 개인정보 안내에서 확인할 수 있습니다. Windows에서는 별도의 설치형 앱 대신 Web 버전을 사용합니다.
macOS 설치와 업데이트
- 홈의 macOS DMG를 다운로드하고 엽니다.
- Publish Lab Notes 앱을 Applications 폴더로 옮긴 뒤 Applications에서 실행합니다.
- 새 버전으로 바꿀 때는 메모를 JSON으로 내보내 보관한 뒤 앱을 종료합니다.
- 새 DMG의 앱으로 Applications의 기존 Publish Lab Notes 앱을 교체합니다. 앱의 저장 데이터를 삭제하지 않습니다.
- 다시 실행하여 버전과 기존 메모를 확인합니다. 이 샘플은 자동 업데이트 기능을 제공하지 않으므로 새 DMG를 직접 내려받습니다.
이 앱은 Developer ID 서명과 Apple 공증을 받았습니다. 출처나 인증서 관련 경고가 나타나면 표시된 오류를 확인하고 문의하십시오.
백업과 다른 기기로 옮기기
- 작성 중인 메모를 먼저 저장합니다.
- 앱과 Web 버전에서는 JSON 내보내기를 열고 JSON을 복사합니다. 텍스트 편집기에서 일반 텍스트로 붙여넣고 UTF-8 인코딩의
.json파일로 저장합니다. 복사만 하고 파일로 저장하지 않으면 백업 파일이 남지 않습니다. - 확장 프로그램에서는 내보내기를 누르면 JSON 파일이 다운로드됩니다. 다운로드한 파일을 안전한 위치에 보관합니다. JSON에는 메모와 저장한 URL이 포함됩니다.
- 옮길 기기의 앱이나 Web 버전에서는 파일 내용을 복사하여 JSON 가져오기 화면에 붙여넣습니다. 확장 프로그램에서는 가져오기를 누르고 해당 JSON 파일을 선택합니다.
- 가져온 뒤 메모 개수와 중요한 메모의 내용을 확인합니다. 확인하기 전에는 원본 파일을 삭제하지 마세요.
기기 사이의 자동 동기화는 제공하지 않습니다. 파일을 다시 가져올 때의 병합 안내를 확인하세요. 동일한 ID의 메모는 수정 시각을 기준으로 처리할 수 있으므로 작업을 옮길 때 각 기기의 날짜와 시각이 맞는지도 확인하세요.
앱 제거, 사이트 데이터 삭제, 브라우저 프로필 삭제 전에 먼저 내보내세요. 백업 파일이 없으면 로컬에서 지운 메모를 서버에서 복구할 수 없습니다.
업데이트가 보이지 않을 때
- 먼저 저장된 메모를 JSON 파일로 보관합니다. 앱과 Web 버전은 내보낸 JSON을 복사하여 파일로 저장하고, 확장 프로그램은 내보내기로 파일을 다운로드합니다.
- Web 버전은 페이지를 새로고침합니다. 설치형 앱과 확장 프로그램은 처음 설치한 공식 배포 경로에서 새 버전을 확인합니다.
- 앱을 다시 열고 표시된 버전과 저장한 메모를 확인합니다. 테스트 배포는 참여한 계정이나 테스트 그룹에 따라 업데이트 제공 여부가 달라질 수 있습니다.
- 계속 문제가 있으면 기기 종류, 운영체제, 브라우저, 앱 버전과 오류 문구를 기록합니다. 메모 본문, 비밀값이 있는 URL, 개인정보가 담긴 화면은 문의 자료에서 제외하세요.
업데이트 문제를 해결하기 위해 앱이나 브라우저 데이터를 먼저 삭제하지 마세요. 제거 후 재설치는 기존 메모를 유지하는 업데이트와 다릅니다.
가져오기에 실패할 때
배포 실습 노트에서 내보낸 JSON인지 확인합니다. 앱과 확장 프로그램은 schemaVersion: 1과 notes 배열을 사용하며, JSON은 UTF-8 기준 2 MiB 이하, 메모 수는 1,000개 이하여야 합니다. 제목은 최대 200자, 본문은 최대 20,000자입니다. 잘못된 날짜, 중복 ID, 지원하지 않는 URL이 있으면 가져오기를 거부합니다.
오류가 발생하면 원본 파일을 별도로 보관하고 표시된 오류를 확인하세요. 파일을 임의로 수정하거나 저장 데이터를 지우기 전에 다른 백업이 있는지 확인하세요.
문의 연락처
문의 이메일: devsunb@gmail.com
기기 종류, 운영체제, 앱 버전과 오류 문구를 알려주십시오. 메모 본문, 비밀값이 있는 URL과 개인정보가 담긴 화면은 보내지 마십시오.