설치
요구 사항, 기본 설치, 그리고 선택적 컴파일 강력 보호용 extra.
패키지 하나로 모든 것이 준비됩니다. magiclock CLI, 호스트 SDK(bootstrap(), open_model()), 그리고 컴파일 강력 보호용 빌드 도구까지 포함됩니다.
요구 사항
- macOS, Windows, Linux에서 Python 3.9–3.14.
- 가상 환경을 권장하지만 필수는 아닙니다 — 패키지는
pip install을 실행한 인터프리터에 그대로 설치됩니다. - 편의 티어(코드와 모델 암호화)에는 C 컴파일러가 필요하지 않습니다. 컴파일 강력 보호에는 필요합니다 — 아래를 참고하세요.
설치
shell
pip install magiclock설치 확인
shell
magiclock --version
magiclock --help컴파일 강력 보호용 extra
magiclock build는 앱을 네이티브 바이너리로 컴파일합니다(컴파일 빌드 참고). 이는 Nuitka 기반 빌드 백엔드에 의존하며, 빌드 머신에 C 툴체인이 필요합니다.
shell
pip install "magiclock[build]"| 플랫폼 | 툴체인 |
|---|---|
| macOS | Xcode 커맨드라인 도구(xcode-select --install) |
| Linux | 배포판의 패키지 관리자로 설치하는 gcc/clang |
| Windows | MSVC Build Tools, 또는 MinGW-w64 |
[build] extra와 툴체인은 실제로 magiclock build를 실행하는 머신에만 필요합니다 — 나중에 컴파일된 결과물을 실행하는 머신에는 필요 없습니다.
업그레이드
shell
pip install --upgrade magiclockCLI/SDK 버전을 업그레이드해도 암호화된 산출물과 라이선스에는 영향이 없습니다.
CI와 컨테이너
설치 방식은 컨테이너나 CI 러너 안에서도 동일합니다 — 설치 자체에는 GUI에 의존하는 부분이 없습니다. 비대화형 활성화(즉 magiclock protect가 브라우저를 열 필요가 없도록 하는 것)는 계정 및 활성화에서 다룹니다.