grist-electron

오프라인 로컬 편집

데스크톱에서 .grist 스프레드시트를 열어 보고, 편집하고, 저장할 수 있습니다. 인터넷이 필요하지 않으므로 네트워크 없이도 동일한 작업을 그대로 수행할 수 있습니다.

Grist 스프레드시트 기능 그대로 사용

Grist Core 기반의 빌드이므로 호스팅 버전과 동일한 스프레드시트 기능을 그대로 사용할 수 있습니다. 다만 서버에서 팀 단위로 협업해 사용하는 경우에는 grist-core 또는 grist-omnibus 같은 자체 호스팅 방식을 권장합니다.

환경 변수를 통한 세부 설정

일반적인 사용에는 별도 설정이 필요하지 않지만, 필요에 따라 환경 변수로 동작을 조정할 수 있습니다. 기본 사용자 이름은 GRIST_DEFAULT_USERNAME, 데이터 저장 위치는 GRIST_DATA_DIR, 데이터베이스 경로는 TYPEORM_DATABASE, 플러그인 설치 경로는 GRIST_USER_ROOT 등으로 지정합니다. 인증 모드는 GRIST_DESKTOP_AUTH를 통해 strict·mixed·none 중 선택하고, 샌드박스 방식은 GRIST_SANDBOX_FLAVOR에서 pyodide·gvisor·macSandboxExec·unsandboxed 중 선택합니다.

설치

Windows 패키지는 winget 명령 한 줄로 설치할 수 있습니다.

• winget install --id GristLabs.GristDesktop --exact

macOS·Linux 또는 수동 설치가 필요한 경우 공식 GitHub 저장소의 Releases 페이지에서 플랫폼별 설치 파일을 받아 설치합니다. 개발 환경에서 직접 빌드하려면 저장소를 받은 뒤 git submodule init, git submodule update, yarn install, yarn run setup, yarn run build, yarn run electron:preview, yarn run electron 순서로 진행합니다.

기본 사용 흐름

• 프로그램을 실행한 뒤 PC에 저장된 .grist 파일을 열어 편집을 시작합니다.
• 수식과 데이터 처리는 호스팅 버전과 동일한 방식으로 동작합니다.
• 저장 위치는 기본적으로 시스템의 문서 폴더를 사용하며, 필요하면 GRIST_DATA_DIR로 다른 위치를 지정할 수 있습니다.
• 자동 업데이트 기능은 GRIST_DESKTOP_USE_UPDATE로 켜고 끌 수 있습니다.

인터넷 연결 없이도 사용할 수 있나요?

예. 인터넷 연결 없이도 로컬에서 .grist 스프레드시트를 열어 편집할 수 있습니다.

Windows에서 가져온 문서가 열리지 않으면 어떻게 하나요?

Windows 보안 정책상 비관리자는 심볼릭 링크 생성 권한이 필요합니다. Microsoft의 안내에 따라 신뢰할 수 있는 경우에만 그룹 정책 편집기(gpedit.msc)로 ‘심볼릭 링크 만들기’ 권한을 부여하고, 부여하기 어렵다면 대안 방법을 기다리거나 다른 방식으로 파일을 옮겨 사용합니다.

팀 단위로 협업해서 사용하려면 어떻게 해야 하나요?

그리스트 데스크톱은 단일 PC 사용을 위한 빌드이므로 팀 협업은 grist-core 또는 grist-omnibus를 사용한 자체 호스팅 서버를 권장합니다.