[python] cx_Freeze를 사용하여 파이썬 패키지를 실행 파일로 패키징하는 방법

22 Nov 2023

python

파이썬으로 작성된 프로그램을 실행 파일 형태로 패키징하면 사용자가 파이썬 환경을 설치하지 않고도 프로그램을 실행할 수 있습니다. cx_Freeze는 파이썬 프로그램을 실행 파일로 변환해주는 유용한 라이브러리입니다. 이번 글에서는 cx_Freeze를 사용하여 파이썬 패키지를 실행 파일로 패키징하는 방법에 대해 알아보겠습니다.

1. cx_Freeze 설치

cx_Freeze를 사용하기 위해서는 우선 cx_Freeze 패키지를 설치해야 합니다. 다음 명령을 사용하여 cx_Freeze 패키지를 설치할 수 있습니다.

pip install cx_Freeze

2. setup.py 파일 작성

cx_Freeze를 사용하여 실행 파일로 패키징하려면 setup.py 파일을 작성해야 합니다. setup.py 파일은 패키징할 파이썬 모듈과 관련 설정을 정의하는 파일입니다. 아래는 간단한 setup.py 파일의 예시입니다.

import sys
from cx_Freeze import setup, Executable

# 실행 파일에 포함시킬 모듈의 경로
include_files = [
    # 포함시킬 파일이나 폴더의 경로
]

# 빌드 설정
build_exe_options = {
    "packages": [],  # 포함시킬 패키지
    "excludes": [],  # 제외할 패키지
    "include_files": include_files  # 포함시킬 파일이나 폴더
}

# 실행 파일 정보
exe = Executable(
    script="패키지의 진입점 파일",
    base=None,  # 실행 파일의 기본 동작 설정 (None이면 콘솔 모드)
    targetName="실행 파일의 이름"
)

setup(
    name="패키지 이름",
    version="버전",
    description="패키지 설명",
    options={"build_exe": build_exe_options},
    executables=[exe]
)

3. 실행 파일로 패키징

cx_Freeze를 사용하여 실행 파일로 패키징하려면 다음 명령을 사용합니다.

python setup.py build

위 명령을 실행하면 build 폴더 안에 실행 파일이 생성됩니다. 생성된 실행 파일은 해당 시스템에서 실행할 수 있는 독립적인 실행 파일입니다.

마무리

이번 글에서는 cx_Freeze를 사용하여 파이썬 패키지를 실행 파일로 패키징하는 방법에 대해 알아보았습니다. cx_Freeze를 사용하면 사용자는 파이썬 환경 설치 없이도 프로그램을 실행할 수 있습니다. cx_Freeze의 자세한 사용법은 공식 문서를 참고하시기 바랍니다.

참고 자료:

cx_Freeze 공식 문서