Py설치 프로그램 개요
PyInstaller는 Python 애플리케이션과 모든 종속성을 단일 패키지로 묶습니다. 사용자는 Python 인터프리터나 모듈을 설치하지 않고도 패키지된 앱을 실행할 수 있습니다.
선적 서류 비치: | https://pyinstaller.org/ |
---|
암호: | https://github.com/pyinstaller/pyinstaller |
---|
PyInstaller는 사용자가 작성한 Python 스크립트를 읽습니다. 코드를 분석하여 스크립트를 실행하는 데 필요한 다른 모든 모듈과 라이브러리를 검색합니다. 그런 다음 활성 Python 인터프리터를 포함하여 모든 파일의 복사본을 수집합니다! -- 스크립트와 함께 단일 폴더에 넣거나 선택적으로 단일 실행 파일에 넣습니다.
PyInstaller는 Windows, macOS 및 GNU/Linux에 대해 테스트되었습니다. 그러나 이는 크로스 컴파일러가 아닙니다. Windows 앱을 만들려면 Windows에서 PyInstaller를 실행하세요. GNU/Linux 앱을 만들려면 GNU/Linux 등에서 실행하세요. PyInstaller는 AIX, Solaris, FreeBSD 및 OpenBSD에서 성공적으로 사용되었지만 지속적인 통합 테스트의 일부로 이에 대해 테스트되지 않았습니다.
주요 장점
- 모든 Python 버전 3.8-3.13에서 기본적으로 작동합니다.
- 완전 다중 플랫폼이며 OS 지원을 사용하여 동적 라이브러리를 로드하므로 완전한 호환성이 보장됩니다.
- numpy, PyQt5, PySide2, PyQt6, PySide6, wxPython, matplotlib 및 기타 기본 Python 패키지와 같은 주요 Python 패키지를 올바르게 번들링합니다.
- 기본적으로 다양한 타사 패키지와 호환됩니다. (외부 패키지를 작동시키는 데 필요한 모든 트릭이 이미 통합되어 있습니다.)
- macOS에서 코드 서명과 함께 작동합니다.
- Windows에서 MS Visual C++ DLL을 번들로 제공합니다.
설치
PyInstaller는 PyPI에서 사용할 수 있습니다. pip를 통해 설치할 수 있습니다.
요구 사항 및 테스트된 플랫폼
- 파이썬:
- 3.8-3.13. Python 3.10.0에는 PyInstaller에서 지원할 수 없게 만드는 버그가 포함되어 있습니다. PyInstaller는 Python 3.14 베타 릴리스에서도 작동하지 않습니다.
- 윈도우(32비트/64비트/ARM64):
- PyInstaller는 Windows 7 이상에서 작동하지만 공식적으로는 Windows 8 이상만 지원합니다.
- 가상 환경을 사용하지 않고 Windows 스토어에서 설치된 Python을 지원하려면 PyInstaller 4.4 이상이 필요합니다.
- 리눅스:
-
x86_64
, aarch64
, i686
, ppc64le
, s390x
아키텍처의 GNU libc 기반 배포판입니다. -
x86_64
, aarch64
아키텍처의 musl libc 기반 배포판입니다. - ldd: 각 프로그램이나 공유 라이브러리에 필요한 공유 라이브러리를 인쇄하는 콘솔 응용 프로그램입니다. 이는 일반적으로 배포 패키지 glibc 또는 libc-bin에서 찾을 수 있습니다.
- objdump: 객체 파일의 정보를 표시하는 콘솔 애플리케이션입니다. 이는 일반적으로 배포 패키지 binutils에서 찾을 수 있습니다.
- objcopy: 객체 파일을 복사하고 번역하는 콘솔 애플리케이션입니다. 이는 일반적으로 배포 패키지 binutils에서도 찾을 수 있습니다.
-
armv5
- armv7
의 Raspberry Pi 사용자는 piwheels를 추가 색인 URL로 추가한 다음 평소대로 pip install pyinstaller
.
- macOS(
x86_64
또는 arm64
): - macOS 10.15(Catalina) 이상.
- Python 설치 및 모든 종속 항목도
universal2
로 컴파일된 경우 universal2
애플리케이션 빌드를 지원합니다.
용법
기본 사용법은 매우 간단합니다. 기본 스크립트에 대해 실행하면 됩니다.
pyinstaller /path/to/yourscript.py
자세한 내용은 설명서를 참조하세요.
테스트되지 않은 플랫폼
다음 플랫폼이 기여되었으며 이에 대한 피드백이나 개선 사항을 환영합니다.
- FreeBSD
- 솔라리스
- AIX
- AIX 6.1 이상. PyInstaller는 정적으로 링크된 Python 라이브러리에서는 작동하지 않습니다.
- ldd
- 위에 나열되지 않은 다른 libc 구현/아키텍처 조합의 Linux.
기여된 플랫폼을 사용하기 전에 PyInstaller 부트로더를 빌드해야 합니다. 적절한 C 컴파일러(일반적으로 gcc
또는 clang
)와 zlib의 개발 헤더가 이미 설치되어 있는 경우 pip install pyinstaller
실행하면 자동으로 발생합니다.
지원하다
- 공식 디버깅 가이드: https://pyinstaller.org/en/v6.11.1/when-things-go-wrong.html
- 다양한 사용자가 기여한 도움말 항목: https://github.com/pyinstaller/pyinstaller/wiki
- 웹 기반 Q&A 포럼: https://github.com/pyinstaller/pyinstaller/discussions
- 이메일 기반 Q&A 포럼: https://groups.google.com/g/pyinstaller
이번 릴리스의 변경 사항
매뉴얼의 변경 로그 섹션에서 이번 릴리스의 자세한 변경 사항 목록을 확인할 수 있습니다.