이 가이드는 Linux 운영체제에서 Electron을 빌드하는 방법을 설명합니다.
python -V
를 통해 버전을 확인할 필요가 있습니다.Ubuntu를 사용하고 있다면 다음과 같이 라이브러리를 설치해야 합니다:
$ sudo apt-get install build-essential clang libdbus-1-dev libgtk2.0-dev \
libnotify-dev libgnome-keyring-dev libgconf2-dev \
libasound2-dev libcap-dev libcups2-dev libxtst-dev \
libxss1 libnss3-dev gcc-multilib g++-multilib curl \
gperf bison
Fedora를 사용하고 있다면 다음과 같이 라이브러리를 설치해야 합니다:
$ sudo yum install clang dbus-devel gtk2-devel libnotify-devel libgnome-keyring-devel \
xorg-x11-server-utils libcap-devel cups-devel libXtst-devel \
alsa-lib-devel libXrandr-devel GConf2-devel nss-devel bison \
gperf
다른 배포판의 경우 pacman 같은 패키지 매니저를 통해 패키지를 설치 할 수 있습니다. 패키지의 이름은 대부분 위 예시와 비슷할 것입니다. 또는 소스 코드를 내려받아 직접 빌드하는 방법도 있습니다.
$ git clone https://github.com/electron/electron.git
부트스트랩 스크립트는 필수적인 빌드 의존성 라이브러리들을 모두 다운로드하고 프로젝트
파일을 생성합니다. 스크립트가 정상적으로 작동하기 위해선 Python 2.7.x 버전이
필요합니다. 아마 다운로드 작업이 상당히 많은 시간을 소요할 것입니다. 참고로 Electron은
ninja
를 빌드 툴체인으로 사용하므로 Makefile
은 생성되지 않습니다.
$ cd electron
$ ./script/bootstrap.py -v
arm
아키텍쳐로 빌드 하려면 다음 의존성 라이브러리를 설치해야 합니다:
$ sudo apt-get install libc6-dev-armhf-cross linux-libc-dev-armhf-cross \
g++-arm-linux-gnueabihf
그리고 bootstrap.py
스크립트의 --target_arch
파라미터에 arm
또는 ia32
아키텍쳐를 지정하여 크로스 컴파일 할 수 있습니다:
$ ./script/bootstrap.py -v --target_arch=arm
Release
와 Debug
두 타겟 모두 빌드 합니다:
$ ./script/build.py
이 스크립트는 out/R
디렉터리에 크기가 매우 큰 Electron 실행 파일을 배치합니다. 파일
크기는 1.3GB를 초과합니다. 이러한 문제가 발생하는 이유는 Release 타겟 바이너리가
디버그 심볼을 포함하기 때문입니다. 파일 크기를 줄이려면 create-dist.py
스크립트를
실행하세요:
$ ./script/create-dist.py
이 스크립트는 매우 작은 배포판을 dist
디렉터리에 생성합니다. create-dist.py
스크립트를 실행한 이후부턴 1.3GB에 육박하는 공간을 차지하는 out/R
폴더의 바이너리는
삭제해도 됩니다.
또는 Debug
타겟만 빌드 할 수 있습니다:
$ ./script/build.py -c D
빌드가 모두 끝나면 out/D
디렉터리에서 electron
디버그 바이너리를 찾을 수 있습니다.
빌드 파일들을 정리하려면:
$ npm run clean
미리 빌드된 clang
은 libtinfo.so.5
로 링크를 시도합니다. 따라서 플랫폼에 따라
적당한 libncurses
symlink를 추가하세요:
$ sudo ln -s /usr/lib/libncurses.so.5 /usr/lib/libtinfo.so.5
빌드 시스템 개요: 테스트를 보세요.
기본적인 빌드 구성은 가장 주력인 Linux 배포판에 초점이 맞춰져있으며, 특정 배포판이나 기기에 빌드할 계획이라면 다음 정보들이 도움이 될 것입니다.
libchromiumcontent
빌드하기미리 빌드된 libchromiumcontent
를 사용하는 것을 피하기 위해, bootstrap.py
스크립트에 --build_libchromiumcontent
스위치를 추가할 수 있습니다:
$ ./script/bootstrap.py -v --build_libchromiumcontent
참고로 shared_library
구성은 기본적으로 빌드되어있지 않으며, 다음 모드를 사용하면
Release
버전의 Electron만 빌드할 수 있습니다:
$ ./script/build.py -c R
clang
바이너리 대신 시스템의 clang
사용하기기본적으로 Electron은 Chromium 프로젝트에서 제공하는 미리 빌드된 clang
바이너리를
통해 빌드됩니다. 만약 어떤 이유로 시스템에 설치된 clang
을 사용하여 빌드하고 싶다면,
bootstrap.py
를 --clang_dir=<path>
스위치와 함께 실행함으로써 해결할 수 있습니다.
빌드 스크립트를 이 스위치와 함께 실행할 때 스크립트는 <path>/bin/
와 같은 경로로
clang
바이너리를 찾습니다.
예를 들어 clang
을 /user/local/bin/clang
에 설치했다면 다음과 같습니다:
$ ./script/bootstrap.py -v --build_libchromiumcontent --clang_dir /usr/local
$ ./script/build.py -c R
clang
대신 다른 컴파일러 사용하기Electron을 g++
과 같은 다른 컴파일러로 빌드하려면, 먼저 --disable_clang
스위치를
통해 clang
을 비활성화 시켜야 하고, 필요하다면 CC
와 CXX
환경 변수도 설정합니다.
예를 들어 GCC 툴체인을 사용하여 빌드한다면 다음과 같습니다:
$ env CC=gcc CXX=g++ ./script/bootstrap.py -v --build_libchromiumcontent --disable_clang
$ ./script/build.py -c R
또한 CC
와 CXX
와는 별개로, 빌드 구성을 변경하기 위해 다음 환경 변수들을 사용할 수
있습니다:
CPPFLAGS
CPPFLAGS_host
CFLAGS
CFLAGS_host
CXXFLAGS
CXXFLAGS_host
AR
AR_host
CC
CC_host
CXX
CXX_host
LDFLAGS
이 환경 변수는 bootstrap.py
스크립트를 실행할 때 설정되어야 하며, build.py
스크립트에선 작동하지 않습니다.