Nuitka
1.0.0
이 문서는 Nuitka 사용을 시작할 때 먼저 읽어볼 것을 권장합니다. 이 페이지에서는 라이선스 유형, 사용 사례, 요구 사항, 크레딧 등 Nuitka 기본 사항에 대해 자세히 알아봅니다.
목차
요구사항
용법
Windows에서 튜토리얼 설정 및 빌드
사용 사례
개조
일반적인 문제
팁
편집 보고서
성능
지원되지 않는 기능
Nuitka는 Python 컴파일러입니다. 파이썬으로 작성되었습니다. 이는 Python 인터프리터를 완벽하게 대체하거나 확장하며 Python 버전에서 실행될 때 Python 2(2.6, 2.7) 및 Python 3(3.4 - 3.13)이 포함하는 모든 구성을 컴파일합니다.
그런 다음 컴파일되지 않은 코드와 컴파일된 코드를 매우 호환 가능한 방식으로 함께 실행합니다.
모든 Python 라이브러리 모듈과 모든 확장 모듈을 자유롭게 사용할 수 있습니다.
Nuitka는 Python 모듈을 C 레벨 프로그램으로 변환한 다음 libpython 및 자체 정적 C 파일을 사용하여 CPython과 동일한 방식으로 실행합니다.
모든 최적화는 불필요한 오버헤드를 방지하는 것을 목표로 합니다. 표준 Python의 모든 버그가 에뮬레이션되지는 않는 등 약간의 개선이 가끔 이루어지긴 하지만 호환성 제거를 목표로 하는 것은 없습니다. 예를 들어 더 완전한 오류 메시지가 제공되지만 이를 비활성화하는 전체 호환성 모드도 있습니다.
Nuitka 의 원활한 작동을 보장하려면 다음 구성 요소를 포함하는 시스템 요구 사항을 따르십시오.
C 컴파일러
파이썬
운영 체제
건축학
C11을 지원하는 C 컴파일러 또는 C++03[1]용 C++ 컴파일러가 필요합니다.
현재 이는 다음 컴파일러 중 하나를 사용해야 함을 의미합니다.
Windows의 MinGW64 C11 컴파일러는 gcc 11.2 이상을 기반으로 해야 합니다. 사용 가능한 C 컴파일러가 없으면 자동으로 다운로드됩니다. 이는 Nuitka가 자동으로 업그레이드하므로 권장되는 설치 방법입니다.
Windows [2]의 Visual Studio 2022 이상. 최상의 결과를 위한 영어 팩(Nuitka는 쓰레기 출력을 필터링하지만 영어에만 해당). 설치되면 기본적으로 사용됩니다.
다른 모든 플랫폼에서는 버전 5.1 이상의 gcc 컴파일러와 대안으로 버전 4.4 이상의 g++ 컴파일러가 필요합니다.
macOS X 및 대부분의 FreeBSD 아키텍처의 clang 컴파일러입니다.
Windows에서는 Visual Studio 설치 프로그램에서 제공하는 경우 Windows의 clang-cl 컴파일러를 사용할 수 있습니다.
| [1] | 이 C11에 대한 지원은 gcc 5.x 이상 또는 모든 clang 버전에서 제공됩니다. 이전 MSVC 컴파일러는 아직 이를 수행하지 않습니다. 그러나 해결 방법으로 Python 3.10 이하에서는 C++03 언어 표준이 C11과 상당히 겹치므로 대신 사용됩니다. |
| [2] | https://www.visualstudio.com/en-us/downloads/download-visual-studio-vs.aspx에서 무료로 다운로드하세요(커뮤니티 버전은 잘 작동합니다). 최신 버전이 권장되지만 필수는 아닙니다. 반면, Windows 10 이전 버전을 지원하는 것을 제외하고는 필요하지 않으며 귀하에게 적합할 수도 있지만 이러한 구성에 대한 지원은 상용 사용자에게만 제공됩니다. |
Python 2 (2.6, 2.7) 및 Python 3 (3.4~3.13)이 지원됩니다. 언제든지 이 목록에 없는 안정적인 Python 릴리스가 있으면 작업 중이므로 추가될 예정이므로 안심하시기 바랍니다.
중요한
Python 3.4 및 해당 버전의 경우 에만 컴파일 시간 종속성으로 다른 Python 버전이 필요합니다.
Nuitka 자체는 나열된 모든 버전과 완벽하게 호환되지만 내부적으로 사용되는 도구인 Scons는 그렇지 않습니다.
이러한 버전의 경우 Python2 또는 Python 3.5 이상이 설치되어 있어야 하지만 컴파일 시간에만 가능합니다. 이는 Nuitka와 동일한 Python 버전을 지원하지 않는 Scons(C 컴파일을 조정하는)와 함께 사용하기 위한 것입니다.
또한 Windows에서는 clcache 작동하지 않기 때문에 Python2를 사용할 수 없으므로 Python 3.5 이상이 설치되어 있어야 합니다.
Nuitka는 필요한 Python 버전(예: Windows에서 레지스트리를 통해)을 찾아 설치되어 있는 한 이를 알아차리지 않아야 합니다.
다른 Python에 특정 패키지가 설치되어 있으면 다른 기능을 점점 더 사용할 수 있습니다. 예를 들어, zstandard 패키지가 설치된 다른 Python이 발견되면 Python 2.x에서 단일 파일 압축이 작동합니다.
바이너리를 다른 컴퓨터로 이동
생성된 바이너리는 --standalone 및 --onefile 옵션을 사용하여 Python 설치와 관계없이 실행 가능하게 만들 수 있습니다.
바이너리 파일 이름 접미사
생성된 바이너리에는 Windows에서 .exe 접미사가 붙습니다. 다른 플랫폼에는 독립 실행형 모드에 대한 접미사 또는 .bin 접미사가 없으므로 자유롭게 제거하거나 변경하거나 -o 옵션으로 지정할 수 있습니다.
원본 스크립트 이름과 바이너리 이름이 충돌하지 않도록 가속 모드에 대한 접미사가 추가되므로 원본 소스 파일을 손상시키지 않고 바이너리를 안전하게 덮어쓸 수 있습니다.
CPython, Anaconda Python 또는 Homebrew 여야 합니다 .
Nuitka를 실행하려면 "CPython"이라는 표준 Python 구현이 필요합니다. 왜냐하면 Nuitka는 구현 세부 사항과 밀접하게 연결되어 있기 때문입니다.
Windows 앱 스토어에서는 다운로드할 수 없습니다.
Windows 앱 스토어 Python이 확실히 작동하지 않는 것으로 알려져 있으며 이에 대해 확인했습니다.
macOS에서는 pyenv 일 수 없습니다 .
macOS "pyenv"가 작동하지 않는 것으로 알려져 있습니다. 자체 컴파일된 Python 설치에는 대신 Homebrew를 사용하십시오. 그러나 독립 실행형 모드는 이러한 플랫폼에서 더 나쁘고 이전 macOS 버전과 호환되지 않습니다.
지원되는 운영 체제: Linux, FreeBSD, NetBSD, macOS 및 Windows(32비트/64비트/ARM).
다른 사람들도 잘 작동할 것입니다. 이식성은 일반적으로 좋을 것으로 예상되지만, 예를 들어 Nuitka의 내부 Scons 사용법은 조정되어야 하거나 플래그를 전달해야 할 수도 있습니다. Python과 C 컴파일러 아키텍처가 일치하는지 확인하세요. 그렇지 않으면 알 수 없는 오류 메시지가 표시됩니다.
지원되는 아키텍처는 x86, x86_64(amd64) 및 arm 등 훨씬 더 많습니다.
Nuitka는 일반적으로 특정 하드웨어를 사용하지 않기 때문에 다른 아키텍처도 즉시 작동할 것으로 예상됩니다. 이것들은 테스트를 거쳐 좋은 것으로 알려진 것들입니다. 피드백을 환영합니다. 일반적으로 데비안이 지원하는 아키텍처는 좋은 것으로 간주되고 테스트될 수도 있습니다.
Nuitka를 실행하는 데 권장되는 방법은 <the_right_python> -m nuitka 사용하여 어떤 Python 인터프리터를 사용하고 있는지 확실히 알 수 있으므로 Nuitka가 가지고 있는 것과 일치시키는 것이 더 쉽습니다.
환경 변수를 변경하지 않고 소스 체크아웃이나 아카이브에서 Nuitka를 실행하는 다음으로 가장 좋은 방법은 Nuitka에 대해 PYTHONPATH 전혀 사용할 필요가 없다는 점입니다. 환경을 변경하지 않고 nuitka 및 nuitka-run 스크립트를 직접 실행하면 됩니다. 편의를 위해 PATH 에 bin 디렉터리를 추가할 수도 있지만 해당 단계는 선택 사항입니다.
게다가 올바른 인터프리터로 실행하려면 <the_right_python> bin/nuitka 실행하고 잘 작동하도록 하세요.
올바른 통역사를 선택하세요
SyntaxError 가 발생하면 컴파일 중인 프로그램에 대해 잘못된 인터프리터를 선택한 것입니다.
Nuitka에는 수행할 수 있는 작업을 출력하는 --help 옵션이 있습니다.
nuitka --도움말
nuitka-run 명령은 nuitka 와 동일하지만 기본값이 다릅니다. Python 스크립트를 컴파일 하고 직접 실행하려고 시도합니다.
nuitka-run --help
이 다른 옵션은 --run 이며, 생성된 바이너리에 대한 첫 번째 비옵션 이후에 인수를 전달하므로 일반 python 수행하는 작업과 다소 유사합니다.
대부분의 시스템의 경우 Nuitka 다운로드 페이지에 패키지가 있습니다. 그러나 위에서 설명한 대로 소스 코드에서 설치할 수도 있지만 다른 Python 프로그램과 마찬가지로 일반적인 python setup.py install 루틴을 통해 설치할 수도 있습니다.
GitHub 워크플로와의 통합에 대한 알림은 통합을 정말 쉽게 만들어주는 Nuitka-Action을 사용해야 한다는 것입니다. 하지만 로컬 컴파일로 시작해야 하지만 이는 Nuitka를 사용한 크로스 플랫폼 컴파일에 가장 쉽습니다.
Nuitka는 Apache 라이선스 버전 2.0에 따라 라이선스가 부여됩니다. 라이센스를 준수하는 경우를 제외하고는 이를 사용할 수 없습니다.
http://www.apache.org/licenses/LICENSE-2.0에서 라이센스 사본을 얻을 수 있습니다.
해당 법률에서 요구하거나 서면으로 동의하지 않는 한, 라이선스에 따라 배포되는 소프트웨어는 명시적이든 묵시적이든 어떠한 종류의 보증이나 조건 없이 "있는 그대로" 배포됩니다. 라이선스에 따른 허가 및 제한 사항을 관리하는 특정 언어는 라이선스를 참조하세요.
아무것도 설치하지 않은 경우 이는 기본 단계입니다. 물론 부품이 있으면 건너뛰세요.
https://www.python.org/downloads/windows에서 Python을 다운로드하고 설치합니다.
Windows x86-64 web-based installer (64비트 Python, 권장) 또는 x86 executable (32비트 Python) 설치 프로그램 중 하나를 선택합니다.
python --version 명령을 사용하여 작동하는지 확인합니다.
python -m pip install nuitka
python -m nuitka --version 명령을 사용하여 확인합니다.
mkdir HelloWorld
hello.py 라는 Python 파일을 만듭니다.
def talk(message):return "Talk " + messagedef main():print(talk("Hello World"))if __name__ == "__main__":main()평소대로 하세요. 잘못 작동하는 코드에서 Nuitka를 실행하는 것은 디버그하기가 쉽지 않습니다.
파이썬 hello.py
python -m nuitka hello.py
메모
적절한 MSVC가 설치되어 있지 않은 경우 C 캐싱 도구(생성된 C 코드의 반복 컴파일 속도를 높이기 위해)와 MinGW64 기반 C 컴파일러를 다운로드하라는 메시지가 표시됩니다. 두 질문 모두에 yes 라고 대답하세요.
hello.py 근처에 생성된 hello.exe 실행합니다.
배포하려면 단일 실행 파일이 아닌 전체 폴더를 출력하는 --standalone 옵션을 사용하여 빌드하세요. 결과 hello.dist 폴더를 다른 컴퓨터에 복사하고 실행합니다.
단일 파일을 생성하는 --onefile 시도할 수도 있지만, 이를 사용하기 전에 단순한 독립 실행형이 작동하는지 확인하십시오. 예를 들어 데이터 파일이 누락된 경우 디버깅이 더 어려워지기 때문입니다.
주 프로그램인 단일 파일뿐만 아니라 전체 프로그램을 재귀적으로 컴파일하려면 다음과 같이 하십시오.
python -m nuitka --follow-imports 프로그램.py
메모
--follow-imports 보다 더 세분화된 제어 기능이 있습니다. nuitka --help 의 출력을 고려해보세요. 컴파일에 더 적은 수의 모듈을 포함하지만 대신 일반 Python을 사용하면 컴파일 속도가 더 빨라집니다.
동적으로 로드된 파일이 있는 소스 디렉토리가 있는 경우, 즉 PYTHONPATH 를 통해 일반적인 import 문 이후에 반복적으로 찾을 수 없는 파일(권장되는 방법)이 있는 경우 항상 주어진 디렉토리도 포함되도록 요구할 수 있습니다. 실행 파일:
python -m nuitka --follow-imports --include-plugin-directory=plugin_dir program.py
메모
동적 가져오기를 수행하지 않는 경우 컴파일 시간에 PYTHONPATH 설정하기만 하면 됩니다.
Nuitka가 예측할 수 없고 디렉터리에서 오는 __import__() 호출을 수행하는 경우에만 --include-plugin-directory 사용하세요. Python 설치의 모든 것에 대해 --include-module 또는 --include-package 사용하세요.
메모
결과 파일 이름은 Windows에서는 program.exe , 다른 플랫폼에서는 program.bin 이지만 --output-filename 사용하면 이를 변경할 수 있습니다.
메모
결과 바이너리는 여전히 CPython에 의존하며 설치되는 C 확장 모듈을 사용합니다.
다른 머신에 복사할 수 있게 하려면 --standalone 사용하여 생성된 program.dist 디렉터리를 복사하고 그 안에 담긴 program.exe (Windows) 또는 program (다른 플랫폼)을 실행하면 됩니다.
단일 확장 모듈을 컴파일하려면 다음을 수행하면 됩니다.
python -m nuitka --module some_module.py
그런 다음 결과 파일 some_module.so 를 some_module.py 대신 사용할 수 있습니다.
중요한
Python은 모듈 이름 파생 함수를 진입점으로 주장하므로 생성된 확장 모듈의 파일 이름을 변경해서는 안 됩니다. 이 경우 PyInit_some_module 및 파일 이름을 변경해도 변경되지 않습니다. 소스 코드의 파일 이름을 바이너리 이름과 일치시키십시오.
메모
확장 모듈과 해당 소스 코드가 모두 동일한 디렉터리에 있으면 확장 모듈이 로드됩니다. 소스 코드에 대한 변경 사항은 다시 컴파일한 후에만 적용됩니다.
메모
--follow-import-to 옵션도 작동하지만 포함된 모듈은 some_module 이름을 가져온 후에 만 가져올 수 있습니다. 이러한 종류의 가져오기가 Nuitka에 표시되지 않는 경우(예: 동적으로 생성된 경우) --include-module 또는 --include-package 사용할 수 있지만 정적 가져오기의 경우에는 필요하지 않습니다.
메모
확장 모듈은 다른 확장 모듈을 포함할 수 없습니다. 이 작업을 수행하려면 휠을 만들어야 합니다.
메모
결과 확장 모듈은 동일한 버전의 CPython에만 로드될 수 있으며 다른 확장 모듈은 포함되지 않습니다.
전체 패키지를 컴파일하고 모든 모듈을 포함해야 하는 경우(이 역시 가능함) Nuitka를 다음과 같이 사용하세요.
python -m nuitka --module some_package --include-package=some_package
메모
패키지 콘텐츠 포함은 수동으로 제공해야 합니다. 그렇지 않으면 패키지가 대부분 비어 있습니다. 원하는 경우 더 구체적으로 지정할 수 있으며, 일부만 포함하거나 일부를 제외할 수 있습니다. 예를 들어 --nofollow-import-to='*.tests' 사용하면 코드에서 사용되지 않는 테스트 부분을 포함하지 않습니다.
메모
패키지 내부에 있는 데이터 파일은 이 프로세스에 의해 포함되지 않으므로 이 접근 방식을 사용하여 직접 복사해야 합니다. 또는 Nuitka 광고의 파일 삽입을 사용할 수 있습니다.
다른 시스템에 배포하기 위해 --standalone 지정할 수 있는 폴더를 생성하는 독립형 모드가 있습니다.
python -m nuitka --standalone program.py
이 모드에서는 모든 가져오기를 따르는 것이 기본값입니다. --nofollow-import-to 구체적으로 지정하여 모듈을 선택적으로 제외할 수 있지만, 프로그램 런타임 시 모듈 가져오기를 시도하면 ImportError 발생합니다. 이로 인해 동작이 달라질 수 있지만 현명하게 수행하면 컴파일 시간이 향상될 수도 있습니다.
데이터 파일을 포함하려면 --include-data-files=<source>=<target> 옵션을 사용합니다. 여기서 소스는 파일 시스템 경로이지만 대상은 상대적으로 지정해야 합니다. 독립 실행형 모드의 경우 수동으로 복사할 수도 있지만 추가 확인이 가능하며 단일 파일 모드의 경우 수동 복사가 불가능합니다.
디렉토리의 일부 또는 전체 파일을 복사하려면 --include-data-files=/etc/*.txt=etc/ 옵션을 사용하여 파일에 대한 쉘 패턴을 지정하고 파일을 넣을 하위 디렉토리를 지정하십시오. 후행 슬래시로.
중요한
Nuitka는 데이터 파일 코드를 고려하지 않으며, DLL 또는 Python 파일을 데이터 파일로 포함하지 않으며, 실제로 수행 중인 작업을 알지 않는 한 작동하지 않을 것으로 예상합니다.
다음에서 코드가 아닌 데이터 파일은 모두 이러한 기준과 일치하지 않는 파일입니다.
| 접미사 | 이론적 해석 | 해결책 |
|---|---|---|
.py | Nuitka는 포함될 stdlib 모듈까지 다듬습니다. Python 코드가 표시되지 않으면 분석된 종속성이 없으므로 결과적으로 작동하지 않습니다. | 대신 --include-module 사용하세요. |
.pyc | .py 와 동일합니다. | 대신 소스 코드에서 --include-module 사용하세요. |
.pyo | .pyc 와 동일합니다. | 대신 소스 코드에서 --include-module 사용하세요. |
.pyw | .py 와 동일합니다. | 여러 프로그램을 포함하려면 대신 여러 --main 인수를 사용하세요. |
.pyi | 이는 코드와 유사하고 런타임에 필요하지 않기 때문에 무시됩니다. 실제로 의존하는 lazy 패키지에 대해 우리는 필요성을 제거하는 컴파일 타임 솔루션을 만들었습니다. | 타사 소프트웨어에 필요한 경우 문제를 제기하세요. |
.pyx | 런타임에 사용되지 않는 Cython 소스 코드이므로 무시됩니다. | |
.dll | 이는 일반적으로 데이터 파일이 아니기 때문에 무시됩니다. 타사 패키지(예: .NET 패키지)가 실제로 데이터로 사용하는 경우 패키지 구성에서 이를 해결합니다. | 이를 사용하는 패키지에 대한 dll 섹션을 사용하여 Nuitka 패키지 구성을 만듭니다. 드문 경우지만 특수 구성이 포함된 데이터 파일 섹션을 사용하는 것이 올바른 방법일 수 있습니다. |
.dylib | 이는 macOS 확장 모듈 또는 DLL이므로 무시됩니다. | dll 섹션이 포함된 구성을 추가해야 하거나 누락된 부분에 depends |
.so | 이는 Linux, BSD 등의 확장 모듈 또는 DLL이므로 무시됩니다. | dll 섹션이 포함된 구성을 추가해야 하거나 누락된 부분에 depends |
.exe | Windows의 바이너리입니다. | Nuitka 패키지 구성을 추가하여 이를 DLL로 포함하고 executable: yes |
.bin | Windows 이외의 바이너리이며, 그렇지 않으면 .exe 와 동일합니다. |
또한 폴더는 무시됩니다. 이는 전체 virtualenv를 포함하는 site-packages , dist-packages 및 vendor-packages 이며 이는 결코 좋은 일이 아닙니다. 그리고 __pycache__ 폴더도 항상 무시됩니다. MacOS가 아닌 경우 .DS_Store 파일도 무시되고 py.typed 폴더는 IDE에만 의미가 있으며 .pyi 파일처럼 무시됩니다.
코드가 아닌 모든 파일이 포함된 전체 폴더를 복사하려면 해당 파일을 대상에 배치하는 --include-data-dir=/path/to/images=images 사용할 수 있으며, --noinclude-data-files 를 사용하려는 경우 --noinclude-data-files 옵션을 사용하여 제거합니다. 코드 파일은 DLL, 실행 파일, Python 파일 등에 대해 위에 자세히 설명되어 있으며 무시됩니다. 이러한 경우 --include-data-files=/binaries/*.exe=binary/ 형식을 사용하여 강제로 적용할 수 있지만 이는 권장되지 않으며 런타임 시 문제를 일으키는 것으로 알려져 있습니다.
패키지 데이터의 경우 --include-package-data 사용하는 더 좋은 방법이 있습니다. 이 방법은 패키지의 코드가 아닌 모든 데이터 파일을 자동으로 감지하여 복사합니다. 쉘 스타일의 패턴도 허용합니다. 패키지 디렉터리를 직접 찾을 필요가 없으며 가능할 때마다 선호되어야 합니다. 기능적으로는 --include-data-dir 과 매우 유사하지만 올바른 폴더를 찾을 수 있다는 이점이 있습니다.
데이터 파일을 사용하면 대부분 혼자서 작업할 수 있습니다. Nuitka는 인기 있는 패키지에 필요한 패키지를 추적하지만 불완전할 수 있습니다. 이러한 문제가 발생하면 문제를 제기하세요. 더 좋은 점은 Nuitka 패키지 구성을 개선하여 PR을 높이는 것입니다. 우리는 타사 소프트웨어가 즉시 작동하기를 원합니다.
작동 중일 때 원하는 경우 onefile 모드를 사용할 수 있습니다.
python -m nuitka --onefile 프로그램.py
그러면 프로그램을 실행하기 전에 대상에서 자체적으로 추출되는 단일 바이너리가 생성됩니다. 그러나 프로그램과 관련된 파일에 액세스하는 것이 영향을 받는다는 점에 유의하세요. Onefile: 파일 찾기 섹션도 읽어보세요.
# 임시 폴더에 압축을 푸는 바이너리를 만듭니다python -m nuitka --onefile program.py
메모
예를 들어 아이콘, 스플래시 화면 및 버전 정보와 관련된 더 많은 플랫폼별 옵션이 있습니다. 이에 대한 자세한 내용은 --help 출력을 고려하고 Tweaks 섹션을 확인하세요.
압축 풀기의 경우 기본적으로 고유한 사용자 임시 경로 1이 사용된 다음 삭제됩니다. 그러나 이 기본값 --onefile-tempdir-spec="{TEMP}/onefile_{PID}_{TIME}" 경로로 재정의될 수 있습니다. 사양을 지정한 다음 캐시된 경로를 사용하여 반복적인 압축 풀기를 방지합니다(예: 버전 정보를 사용하는 --onefile-tempdir-spec="{CACHE_DIR}/{COMPANY}/{PRODUCT}/{VERSION}" 사용). 사용자별 캐시 디렉토리.
메모
캐시된 경로를 사용하는 것은 관련이 있습니다(예: Windows 방화벽이 작동할 때). 그렇지 않으면 실행될 때마다 바이너리가 달라지기 때문입니다.
현재 다음과 같은 확장 토큰을 사용할 수 있습니다.
| 토큰 | 이것이 확장되는 대상 | 예 |
|---|---|---|
| {TEMP} | 사용자 임시 파일 디렉터리 | C:사용자...AppDataLocalsTemp |
| {PID} | 프로세스 ID | 2772 |
| {시간} | 에포크 이후의 시간(초)입니다. | 1299852985 |
| {프로그램} | 실행 파일의 전체 프로그램 런타임 파일 이름입니다. | C:SomeWhereYourOnefile.exe |
| {PROGRAM_BASE} | 실행 파일의 런타임 파일 이름에 접미사가 없습니다. | C:SomeWhereYourOnefile |
| {CACHE_DIR} | 사용자의 캐시 디렉터리입니다. | C:UsersSomeBodyAppDataLocal |
| {회사} | --company-name 으로 지정된 값 | 귀하의 회사 이름 |
| {제품} | --product-name 으로 지정된 값 | 귀하의 제품 이름 |
| {버전} | --file-version 및 --product-version 의 조합 | 3.0.0.0-1.0.0.0 |
| {집} | 사용자의 홈 디렉터리입니다. | /집/누군가 |
| {없음} | 파일 출력에 제공되는 경우 None 이 사용됩니다. | 아래 공지를 참고하세요 |
| {NULL} | 파일 출력에 제공되면 os.devnull 이 사용됩니다. | 아래 공지를 참고하세요 |
중요한
제공된 경로를 고유하게 만드는 것은 사용자의 책임입니다. Windows에서는 실행 중인 프로그램이 잠기며, 고정된 폴더 이름을 사용하는 것이 가능하지만 이 경우 프로그램이 다시 시작되는 경우 잠금 문제가 발생할 수 있습니다.
일반적으로 경로를 고유하게 만들려면 {TIME} 또는 최소한 {PID} 사용해야 하며 이는 주로 사용 사례를 위한 것입니다. 예를 들어 선택한 장소에 항목을 두거나 명명 규칙을 따르기를 원하는 경우입니다.
중요한
--force-stdout-spec 및 --force-stderr-spec 사용하여 출력 및 stderr을 비활성화하려면 {NONE} 및 {NULL} 값을 사용하여 이를 달성하지만 효과는 다릅니다. {NONE} 사용하면 해당 핸들이 None 됩니다. 결과적으로, 예를 들어 sys.stdout None 이 될 것입니다. 이는 os.devnull 을 가리키는 파일에 의해 지원되는 {NULL} 과 다릅니다. 즉, 쓸 수 있습니다.
{NONE} 사용하면 예를 들어 사용되는 경우 RuntimeError: lost sys.stdout 얻을 수 있습니다. 결코 발생하지 않는 {NULL} 사용합니다. 그러나 일부 라이브러리는 이를 로깅 메커니즘에 대한 입력으로 처리하며 Windows에서는 이것이 {NONE} 처럼 동작하는 pythonw.exe 와 호환되는 방식입니다.
setup.py , setup.cfg 또는 pyproject.toml 기반 소프트웨어 휠 생성이 있는 경우 Nuitka를 사용하는 것은 매우 쉽습니다.
가장 일반적인 setuptools 접근 방식부터 시작해 보겠습니다. 물론 Nuitka를 설치하면 bdist_wheel 대신 bdist_nuitka 대상을 실행할 수 있습니다. 여기에는 모든 옵션이 포함되어 있으며 Nuitka에 특정한 추가 옵션을 지정할 수 있습니다.
# 다른 빌드 시스템을 사용하지 않는 경우 setup.py의 경우:setup( # 데이터 파일은 Nuitka가 아닌 setuptools에 의해 처리됩니다.
package_data={"some_package": ["some_file.txt"]},
..., # Nuitka 옵션을 전달하기 위한 것입니다.
command_options={ 'nuitka': { # 부울 옵션, 예를 들어 C 컴파일 명령을 고려한 경우 '--show-scons': True, # 값이 없는 옵션, 예: Clang을 사용하여 적용 '--clang': None, # 옵션 단일 값, 예: Nuitka 플러그인 활성화 '--enable-plugin': "pyside2", # 여러 값이 있는 옵션, 예: 모듈 '--nofollow-import-to' 포함 방지 : ["*.tests", "*.distutils"],
},
},
)# 다른 빌드 시스템을 사용하는 setup.py의 경우:# 인수의 튜플 특성은 # "setuptools" 및 완전한 호환성을 요구하는 플러그인의 어두운 특성에 의해 필요합니다.# 예: "setuptools_rust"setup( # 데이터 파일 Nuitka가 아닌 setuptools에 의해 처리됩니다.
package_data={"some_package": ["some_file.txt"]},
..., # Nuitka 옵션을 전달하기 위한 것입니다.
..., command_options={ 'nuitka': { # 부울 옵션, 예를 들어 C 컴파일 명령을 고려한 경우 '--show-scons': ("setup.py", True), # 값이 없는 옵션, 예를 들어 다음을 사용하여 적용 Clang '--clang': ("setup.py", None), # 단일 값이 있는 옵션(예: Nuitka 플러그인 활성화 '--enable-plugin': ("setup.py", "pyside2"), # 여러 값이 있는 옵션, 예를 들어 '--nofollow-import-to' 모듈을 포함하지 마세요: ("setup.py", ["*.tests", "*.distutils"]),
}
},
) 어떤 이유로 대상을 변경할 수 없거나 변경하고 싶지 않은 경우 이를 setup.py 에 추가할 수 있습니다.
# setup.pysetup의 경우( ..., build_with_nuitka=참)
메모
일시적으로 컴파일을 비활성화하려면 위 줄을 제거하거나 값을 False 로 편집하거나 원하는 경우 환경 변수에서 값을 가져올 수 있습니다(예: bool(os.getenv("USE_NUITKA", "True")) . 이것은 당신에게 달려 있습니다.
아니면 setup.cfg 에 넣을 수도 있습니다.
[메타데이터]build_with_nuitka = true
마지막으로 Nuitka는 새로운 build 메타도 지원하므로 이미 pyproject.toml 이 있는 경우 다음 값을 바꾸거나 추가하면 됩니다.
[build-system]requires = ["setuptools>=42", "wheel", "nuitka", "toml"]build-backend = "nuitka.distutils.Build"# 데이터 파일은 Nuitka가 아닌 setuptools에 의해 처리됩니다. [tool.setuptools.package-data]some_package = ['data_file.txt'] [tool.nuitka]# 권장되지는 않지만 효과가 있음이 분명합니다.# 부울 옵션, 예를 들어 C 컴파일 명령을 고려한 경우 선행# 대시는 생략됩니다.show-scons = true# 단일 값이 있는 옵션, 예: 활성화 Nuitkaenable-plugin = "pyside2"#의 플러그인 여러 값이 있는 옵션(예: 모듈 포함 방지, 허용# 목록 인수.nofollow-import-to = ["*.tests", "*.distutils"]
메모
C:Users...Nuitka 와 같은 절대 경로 위의 nuitka 요구 사항의 경우 Linux에서도 작동합니다. 앞에 두 개의 슬래시가 있는 절대 경로를 사용하세요(예: //home/.../Nuitka .
메모
어떤 접근 방식을 취하든 이러한 휠의 데이터 파일은 Nuitka가 아니라 setuptools에 의해 처리됩니다. 그러나 Nuitka 광고의 데이터 파일 삽입을 사용할 수 있습니다. 이 경우 실제로 휠의 파일이 아니라 확장 모듈 자체 내부에 파일을 포함하게 됩니다.
여러 프로그램이 있고 각 프로그램이 실행 가능해야 하는 경우 과거에는 여러 번 컴파일하고 이 모든 것을 배포해야 했습니다. 물론 독립 실행형 모드를 사용하면 폴더 공유가 가능하기 때문에 상당히 낭비가 되지만 Nuitka에서는 실제로 지원되지 않습니다.
Multidist 입력합니다. 주어진 위치 인수를 대체하거나 추가하는 옵션 --main 이 있습니다. 그리고 여러 번 주어질 수도 있습니다. 여러 번 제공되면 Nuitka는 제공된 모든 프로그램의 코드를 포함하지만 해당 프로그램에 사용된 모듈을 공유하는 바이너리를 생성합니다. 따라서 여러 번 배포할 필요가 없습니다.
기본 경로와 진입점의 기본 이름을 지정해 보겠습니다. 물론 이들의 이름은 달라야 합니다. 그런 다음 생성된 바이너리는 두 진입점 중 하나를 실행할 수 있으며 sys.argv[0] 에 나타나는 내용에 반응합니다. 따라서 올바른 방법으로 실행하거나( subprocess 또는 OS API와 같은 것을 사용하여 이 이름을 제어할 수 있음) 바이너리 이름을 바꾸거나 복사하거나 심볼릭 링크를 사용하면 기적을 이룰 수 있습니다.
이를 통해 매우 다양한 프로그램을 하나로 결합할 수 있습니다.
메모
이 기능은 아직 실험적입니다. 주의해서 사용하고 바람직하지 않은 동작이 발견되면 결과를 보고하세요.
이 모드는 독립 실행형, 단일 파일 및 단순 가속에서 작동합니다. 모듈 모드에서는 작동하지 않습니다.
GitHub 워크플로와 통합하려면 통합을 정말 쉽게 만들어주는 Nuitka-Action을 사용해야 합니다. 하지만 로컬 컴파일로 시작해야 하지만 이는 Nuitka를 사용한 크로스 플랫폼 컴파일에 가장 쉽습니다.
이는 3가지 OS 모두를 기반으로 구축된 워크플로 예시입니다.
작업:빌드: 전략: 매트릭스: os: [macos-latest, ubuntu-latest, windows-latest]
실행 시: ${{ 매트릭스.os }}
단계:
- 이름: 체크아웃 저장소 사용: actions/checkout@v4 - 이름: Setup Python 사용: actions/setup-python@v5 with: python-version: '3.10' 캐시: 'pip' 캐시 종속성 경로: | **/requirements*.txt - 이름: 종속성 설치 실행: | pip install -r 요구 사항.txt -r 요구 사항-dev.txt - name: Build Executable with Nuitka 용도: Nuitka/Nuitka-Action@main with: nuitka-version: main script-name: your_main_program.py # 더 많은 Nuitka 옵션 사용 가능 , 작업 문서를 참조하세요. 하지만 # 코드에서 nuitka-project: 옵션을 사용하는 것이 가장 좋습니다. 예를 들어 # macOS에 차이를 만들고 거기에서 앱 번들을 생성할 수 있습니다. onefile: true - 이름: Upload Artifacts 사용: actions/upload-artifact@v3 포함: 이름: ${{runner.os }} 빌드 경로: | # 3가지 OS용으로 생성된 것과 일치 build/*.exe build/*.bin build/*.app/**/* 앱이 GUI인 경우, 예를 들어 your_main_program.py 에는 코드의 Nuitka 옵션에 설명된 대로 이러한 주석이 포함되어야 합니다. macOS에서는 이것이 번들이어야 하기 때문입니다.
# 컴파일 모드, 독립 실행형, macOS 제외 app Bundle# nuitka-project-if: {OS} in ("Windows", "Linux", "FreeBSD"):# nuitka-project: --onefile# nuitka-project -if: {OS} == "Darwin":# nuitka-project: --standalone# nuitka-project: --macos-create-app-bundle#보기 좋게 보이도록 아이콘을 지정할 수 있습니다. Windows에서는 아이콘 파일, 템플릿 실행 파일 또는 PNG 파일을 제공할 수 있습니다. 이 모든 기능은 작동하며 결합될 수도 있습니다.
# 이는 Windowspython -m nuitka --onefile --windows-icon-from-ico=your-icon.png program.py에 아이콘이 있는 바이너리를 생성합니다. python -m nuitka --onefile --windows-icon-from-ico=your-icon.ico program.py python -m nuitka --onefile --windows-icon-template-exe=your-icon.ico program.py# 이는 macOS에서 아이콘이 포함된 애플리케이션 번들을 생성합니다python -m nuitka --macos-create-app-bundle --macos- app-icon=your-icon.png 프로그램.py python -m nuitka --macos-create-app-bundle --macos-app-icon=your-icon.icns program.py
메모
Nuitka를 사용하면 플랫폼별 아이콘을 만들 필요가 없지만 대신 빌드 중에 PNG뿐만 아니라 다른 형식도 즉시 변환합니다.
macOS 애플리케이션 번들에 대한 자격은 --macos-app-protected-resource 옵션을 사용하여 추가할 수 있습니다. 모든 값은 Apple의 이 페이지에 나열됩니다.
예제 값은 마이크에 대한 액세스를 요청하기 위한 --macos-app-protected-resource=NSMicrophoneUsageDescription:Microphone access 입니다. 콜론 뒤에는 설명 텍스트가 제공됩니다.
메모
설명 부분에 공백을 사용하는 경우 쉘이 Nuitka를 통과하고 Nuitka 인수로 해석되지 않도록 이를 인용해야 한다는 점에 유의하세요.
Windows에서는 별도로 지정하지 않는 한 프로그램에 의해 콘솔이 열리지 않습니다. Nuitka는 기본적으로 이를 표시하지 않지만 --console=force 사용하여 강제로 표시할 수 있습니다. 그런 다음 프로그램이 실행될 때 새 터미널 창이 열립니다.
시작 화면은 프로그램 시작이 느릴 때 유용합니다. Onefile 시작 자체는 느리지 않지만, 여러분의 프로그램은 느리고, 사용하는 컴퓨터가 얼마나 빠른지 실제로 알 수 없기 때문에 가지고 있는 것이 좋을 수도 있습니다. 다행히 Nuitka를 사용하면 Windows에 쉽게 추가할 수 있습니다.
시작 화면의 경우 PNG 파일로 지정해야 하며 프로그램이 준비되면 시작 화면을 비활성화해야 합니다. 예를 들어 가져오기를 완료하고 창을 준비하고 데이터베이스에 연결했으며 시작 화면을 원합니다. 떠나려고. 여기서는 프로젝트 구문을 사용하여 코드를 생성과 결합하고 다음을 컴파일합니다.
# nuitka-project: --onefile# nuitka-project: --onefile-windows-splash-screen-image={MAIN_DIRECTORY}/Splash-Screen.png# 이것이 무엇이든, 분명히print("10초까지 시작 지연..." )import time, tempfile, ostime.sleep(10)# 이 코드를 사용하여 스플래시 화면 제거 신호를 보냅니다.if "NUITKA_ONEFILE_PARENT" in os.environ: Splash_filename = os.path.join( tempfile.gettempdir(), "onefile_%d_splash_feedback.tmp" % int(os.environ["NUITKA_ONEFILE_PARENT"]),
) if os.path.exists(splash_filename): os.unlink(splash_filename)print("완료... 스플래시가 사라져야 합니다.")
...# 나머지 프로그램이 여기에 들어갑니다.프로그램 및 Nuitka 패키징 분석을 위해 편집 보고서를 사용할 수 있습니다. Nuitka에 내장된 템플릿 중 일부가 포함된 템플릿을 제공하여 맞춤형 보고서를 만들 수도 있습니다. 이 보고서에는 모든 세부 정보가 포함되어 있습니다. 예를 들어 모듈을 가져오려고 했지만 찾을 수 없는 경우, 어디서 그런 일이 발생했는지 확인할 수 있습니다. 버그 보고의 경우 보고서를 제공하는 것이 좋습니다.
저작권 및 상표 정보, 회사명, 제품명 등을 편집물에 첨부할 수 있습니다. 그런 다음 이는 Windows에서 생성된 바이너리 또는 macOS의 애플리케이션 번들에 대한 버전 정보에 사용됩니다. 부족한 점을 발견하시면 알려주세요.
기본적으로 Nuitka는 Nuitka의 잘못된 사용을 디버깅하기 위한 일련의 안전 가드와 도우미를 남겨두는 --deployment 없이 컴파일됩니다.
이는 새로운 기능이며 여기에 설명된 다양한 보호 및 도우미를 구현합니다.
따라서 컴파일 후 sys.executable 은 컴파일된 바이너리입니다. multiprocessing , joblib 또는 loky 와 같은 패키지의 경우 일반적으로하는 것은 sys.executable 이있는 전체 python 에서 실행 된 다음 -c command 또는 -m module_name 과 같은 옵션을 사용할 수 있습니다. 서비스 데몬으로 다른 코드를 일시적으로 또는 영구적으로 시작하십시오.
그러나 Nuitka와 함께, 이것은 당신의 프로그램을 다시 실행하고, 이러한 주장을 sys.argv 에, 당신이 그들을 무시할 수있는 곳에, 당신은 다시 자신을 포크하여 도우미 데몬을 시작합니다. 때때로 이것은 CPU 카운트 프로세스를 생성하는 CPU 수 프로세스를 산란합니다. 이는 포크 폭탄이라고하며 거의 모든 시스템에서 쉽게 얼어 붙을 수 있습니다.
그렇기 때문에 이것은 기본 Nuitka에서 발생하는 이유입니다.
./hello.dist/hello.bin -l gele -m foom -n foon -o fooo -p 오류, 프로그램은 '-m'인수로 스스로 전화하려고 시도했습니다. '-No-Deployment-Flag = Self-Excution'으로 비활성화합니다.
귀하의 프로그램에는 자체 명령 줄 구문 분석이있을 수 있으며 다시 실행하려는 지원되지 않는 패키지를 사용하지 않습니다. 이 경우,이 특정 가드를 비활성화하는 --no-deployment-flag=self-execution 사용하는 컴파일 시간이 필요합니다.
일부 패키지는 수입 실패의 원인이 무엇을 의미하는지에 대한 유용한 정보가 생각하는 것을 출력합니다. 컴파일 된 프로그램에는 종종 명백한 잘못이 있습니다. 우리는 비 배포 모드에서 그것들을 수리하려고 노력합니다. 다음은 Pip Install (문제가 아닌)을 요청하는 메시지를 변경하여 사용자에게 imageio 플러그인이 작동하는 포함 명령을 지적하는 메시지를 변경하는 예입니다.
- module-name : 'imageio.core.imopen'
안티 블로트 :
-Preplacements_plain : '`PIP install ImageIO [{config.install_name}]````````````config.install_name' ':'-include-module = {config.module_name}`````er_type = ':'err_type = runtimeerror 'shen :'배포되지 않음 ' 배포 모드는 비교적 새롭고 지속적으로 더 많은 FileNotFoundError 이 추가되었습니다.
이 모든 도우미는 물론 --deployment 로 한 번에 비활성화 될 수 있지만 디버깅의 경우 다시 활성화 할 수 있습니다. Nuitka 프로젝트 옵션과 환경 변수를 사용 하여이 조건부를 만들 수 있습니다.
당신은 그들 모두를 비활성화해야합니까?
우리는 비활성화가 선택적으로 만 발생해야한다고 생각하지만 PYPI 업그레이드를 사용하면 코드가 변경되면 이러한 모든 문제가 다시 들어올 수 있습니다. 배포 모드의 공간 저장은 현재 무시할 수 있으므로 수행하지 않지만 존재하는 내용을 검토하고 검토하십시오. 그것이 당신에게 영향을 줄 수 없다는 것을 알고 있거나 그렇다면 필요하지 않습니다. 미래의 일부는 초보자 수준의 사용에 명확하게 준비 될 것입니다.
Nuitka의 기본 설정으로 Windows에서 Binaries가 컴파일되었으며 일부 AV 공급 업체는 추가 작업을 수행하지 않을 수 있습니다. 이것은 피할 수 있지만 Nuitka Commercial에서만이를 수행하는 방법에 대한 실제 지원과 지침이 있으며,이를 전형적인 광고 만 필요로합니다. https://nuitka.net/doc/commercial.html
Linux 독립형의 경우 다른 Linux 버전에서 작동하는 이진을 구축하는 것은 매우 어렵습니다. 이는 주로 Linux에서 많은 소프트웨어가 구체적으로 구체적인 DLL을 대상으로 구축되기 때문입니다. Glibc와 같은 것들은 다음 바이너리로 구축 된 바이너리로 인코딩되며, 오래된 glibc와 함께 실행되지 않고 하나의 중요한 예를 제시합니다.
해결책은 지원되는 가장 오래된 OS를 구축하는 것입니다. 그것을 선택하고 설정하는 것은 지루할 수 있으므로 로그인하고 유지할 수 있습니다.
