Building Neovim - minsuk-jang/teamproject GitHub Wiki

• 새 버전으로 업그레이드하기 전에 ** 다음 HEAD를 항상 확인하십시오. **

• Quick start
• Running tests
• Optimized builds
• Debug builds
• Localization
• Compiler options
• Xcode and MSVC project files
• Custom Makefile
• Third-party dependencies
• About CMake
• Build prerequisites

1. 빌드 전제 조건이 설치되어 있는지 확인하십시오.
2. 복제 neovim / neovim.
   • ** stable release ** :git checkout v0.2.0 (또는 가장 최근 태그)
3. make를 실행하여 Neovim을 빌드하십시오. (BSD 시스템에서는gmake / GNU Make를 사용합니다.)

• ** 사용자 정의 위치에 설치하려면 ** CMAKE_INSTALL_PREFIX를 설정하십시오 **. Neovim 설치하기를 참조하십시오.

기타 참고 사항 :

• 타사 종속성 (libuv, LuaJIT 등)은 자동으로 .deps /로 다운로드 됩니다. 문제가 있을 경우 FAQ를 참조하십시오.
• 빌드하지 않고Makefile을 생성하려면 :make cmake
• Neovim을 개발하려는 경우 빠른 빌드를 위해 ninja를 설치하십시오. 자동으로 사용됩니다.

이제 종속성을 확인 했으므로 아래에서 설명하는 다른 빌드 대상을 시도 할 수 있습니다.

모든 non-legacy (unit + functional) 테스트를 실행하려면 다음을 수행하십시오 :

LC_ALL=C make test

unit 테스트 만 실행하려면 다음을 수행하십시오 :

LC_ALL=C make unittest

functional tests 만 실행하려면 다음을 수행하십시오 :

LC_ALL=C make functionaltest

fu 만 실행하려면 * 특정 * 단위 테스트: nctional tests 를 실행하십시오 :

TEST_FILE=test/unit/foo.lua make unittest

• 특정 * 기능 테스트를 실행하려면 다음을 수행하십시오 :

  TEST_FILE=test/functional/foo.lua make functionaltest

테스트를 여러 번 반복하려면 다음을 수행하십시오 :

.deps/usr/bin/busted --filter 'foo' --repeat 1000 test/functional/ui/foo_spec.lua

모든 레거시 (Vim) 통합 테스트를 실행하려면 다음을 수행하십시오 :

make oldtest

• 단일 * 레거시 테스트를 실행하려면TEST_FILE = test_name.res '로make'를 실행하십시오. 예 : test_syntax.vim을 실행하려면 :

  TEST_FILE=test_syntax.res make oldtest

• .vm 대신에 .res 확장자가 필요합니다.
• 전체 경로가 아닌 테스트 파일 이름 만 지정하십시오.

$ GDB는 gdbserver에서 테스트 실행으로 설정할 수 있습니다. $ VALGRIND도 설정되면 gdbserver를 직접 시작하지 않고 valgrind에 --vgdb = yes 옵션을 추가합니다.

rm -r build
make clean
make CMAKE_BUILD_TYPE=Release

개발자와 "가장자리" 사용자의 경우, RelWithDebInfo는 디버그 정보를 생성하지 않기 때문에 Release 보다 권장됩니다.

컴파일 후 빌드 유형을 확인하려면 ./build/bin/nvim --version | grep ^ Build 를 참조합니다.

nvim은 일부 라이브러리를 정적으로 링크하기 때문에 이러한 함수 중 일부를 사용할 수 있으려면 디버그 정보로 컴파일해야 할 수도 있습니다.

make distclean
VERBOSE=1 DEBUG=1 make deps

일반 빌드는build / src / nvim / po에.mo 파일을 만듭니다.

*msgfmt : command not found가 표시되면 gettext를 설치해야 합니다. 대부분의 시스템에서 이 패키지는 gettext라고 합니다.

$ LANG에 대한 번역을 확인하려면 make -C build check-po- $ LANG을 실행하십시오. 예 :

make -C build check-po-de
make -C build check-po-pt_BR

• 해당하는 경우make '대신ninja`를 사용하십시오.
• check-po- $ LANG은 ./build/src/nvim/po/check- $ {LANG} .log에 자세한 보고서를 생성합니다. (보고서는nvim에 의해 생성되고msgfmt에 의해 생성되지 않습니다.)

src / nvim / po / $ LANG.po 파일을 최신 문자열로 업데이트 하려면 다음을 실행하십시오 :

make -C build update-po-$LANG

• 해당되는 경우 make '를 ninja`로 대체하십시오.
• **주의 : ** 업데이트 후에는src / nvim / po / cleanup.vim을 실행하십시오.

includes의 체인을 보려면 -H 옵션을 사용하십시오. (# 918).

echo '#include "./src/nvim/buffer.h"' | \
> clang -I.deps/usr/include -Isrc -std=c99 -P -E -H - 2>&1 >/dev/null | \
> grep -v /usr/

• grep -v / usr /는 시스템 헤더 파일을 걸러 내기 위해 사용됩니다.
• -save-temps는 확장 된 매크로 나 주석 처리 된 어셈블리를 보기 위해 추가 될 수 있습니다.

CMake는 여러 개의 프로젝트 파일 형식 으로 내보내는 -G 옵션을 가지고 있습니다. (예 : Xcode 및 Visual Studio).

예를 들어 Xcode의 정적 분석 GUI (# 167)를 사용하려면 Neovim makefile에서 Xcode 프로젝트 파일을 생성해야 합니다. 여기서 neovim /은 메인 Makefile을 포함하는 최상위 네오 빌 소스 코드 디렉토리입니다) :

cmake -G Xcode neovim

그 후 Xcode에서 결과 프로젝트 파일을 엽니다.

메인 Makefile 맨 위에서 참조되는 local.mk를 생성하여 빌드 프로세스를 로컬로 만들수 있습니다. .gitignore에 나열되어 있으므로 여러 브랜치에서 사용할 수 있습니다. **local.mk의 새로운 목표는 기본 make-target보다 우선합니다. **

다음은 local.mk 샘플로 재 구축을 강제하기 위한 타겟을 추가하지만 default-target을 오버라이드하지는 않습니다 :

all:

rebuild:
	rm -rf build
	make

# 1588을 참조하십시오.

CMake를 사용하여 "bundled" 의존성을 빌드하려면 :

mkdir .deps ; cd .deps
cmake ../third-party
make

기본적으로 라이브러리와 헤더는 .deps / usr에 있습니다. 이제 네오 빔을 만들 수 있습니다.

mkdir build ; cd build
cmake ..
make

1. 모든 종속성을 수동으로 설치하십시오.
2. 저장소 루트에 build 디렉토리를 만듭니다.
3. 모든 옵션과 환경을 가지고 cmake ..를 실행하십시오. 예 :
   • CC=clang CFLAGS=" -O0 -g " cmake .. -DMIN_LOG_LEVEL=0 -DCMAKE_BUILD_TYPE=Debug -DCMAKE_INSTALL_PREFIX=$PWD/root -DCLANG_ASAN_UBSAN=ON
4. make를 실행하십시오.

• cmake.org
• cmake -LAH는 모든 변수 정의를 출력합니다.
• build / CMakeCache.txt는 CMake가 사용하는 모든 변수의 해석 된 값을 포함합니다.
• build / compile_commands.json는 각 번역 단위에 대한 완전한 컴파일러 호출을 보여줍니다.

일반적인 요구 사항 (# 1469 참조) :

• 최근 버전의 Clang 또는 GCC 버전 '4.4'이상
• CMake 버전2.8.7 이상, TLS / SSL 지원으로 구축

플랫폼 별 요구 사항은 다음과 같습니다.

sudo apt-get install libtool libtool-bin autoconf automake cmake g++ pkg-config unzip

참고 :libtool-bin은 Ubuntu 16.04 / Debian Jessie 이상에서만 필요합니다.

CentOS / RHEL 6을 사용하는 경우 libuv 의존성 컴파일하기 위해선 최소한 autoconf 버전 2.69가 필요합니다. https://github.com/joyent/libuv/issues/1158을 참조하십시오.

sudo yum -y install libtool autoconf automake cmake gcc gcc-c++ make pkgconfig unzip

sudo zypper install libtool autoconf automake cmake gcc-c++ gettext-tools

sudo pacman -S base-devel cmake unzip

cd path/to/neovim
nix-shell '<nixpkgs>' -A neovim
patchPhase
cmakeConfigurePhase
buildPhase
installPhase

sudo pkg install cmake gmake libtool sha automake pkgconf unzip wget

sha256sum 불일치에 관한 오류가 발생하면 실제 sha256sum은 e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855이고, 이것이 문제입니다 (빈 파일의 sha256sum입니다). 또한 wget이 설치되어 있는지 확인하십시오. LuaRocks는 적어도 FreeBSD에서는 cURL과의 상호 작용이 좋지 않으며 rock를 설치하려고 할 때 LuaJIT의 PANIC과 함께 죽을 것입니다.

doas pkg_add gmake cmake libtool unzip autoconf-2.69p1 automake-1.15
export AUTOCONF_VERSION=2.69
export AUTOMAKE_VERSION=1.15

일부 제 3 자 구성 요소 # 2445-comment로 인해 최상위 Makefile을 사용할 때 빌드가 실패하는 경우가 있습니다. 다음 지침은 CMake를 사용합니다.

mkdir .deps
cd .deps
cmake ../third-party/
gmake
cd ..
mkdir build
cd build
cmake ..
gmake

• Xcode 및 Homebrew 또는 MacPorts를 설치하십시오.

• Xcode 명령 행 도구 설치 xcode-select --install

• 다른 종속성 설치 :

  Via MacPorts:

  sudo port install libtool autoconf automake cmake pkgconfig gettext
  

  Via Homebrew:

  brew install libtool automake cmake pkg-config gettext
  

• 이 후에 테스트가 실행되기 전에 make distclean && make를 실행해야 할 수도 있습니다.

• ** wget 인증서 오류 **가 표시되는 경우 (OS X * 이전 버전 * 10.10 / Yosemite) :

  Via MacPorts:

  sudo port install curl-ca-bundle
  echo CA_CERTIFICATE=/opt/local/share/curl/curl-ca-bundle.crt >> ~/.wgetrc
  

  Via Homebrew:

  brew install curl-ca-bundle
  echo CA_CERTIFICATE=$(brew --prefix curl-ca-bundle)/share/ca-bundle.crt >> ~/.wgetrc
  

MSYS2 shell에서 이 패키지를 설치하십시오 :

pacman -S mingw-w64-x86_64-gcc mingw-w64-x86_64-libtool mingw-w64-x86_64-cmake \
mingw-w64-x86_64-make mingw-w64-x86_64-perl mingw-w64-x86_64-python2 \
mingw-w64-x86_64-pkg-config mingw-w64-x86_64-unibilium gperf

이제 Windows 콘솔 (cmd.exe)에서 PATH를 설정하고 빌드하십시오.

set PATH=%PATH%;c:\msys64\mingw64\bin
set CC=gcc

MinGW Makefiles 생성자를 사용하여 빌드하기

mkdir .deps
cd .deps
cmake  -G "MinGW Makefiles" ..\third-party\
mingw32-make
cd ..
mkdir build
cd build
cmake -G "MinGW Makefiles" -DGPERF_PRG="C:\msys64\usr\bin\gperf.exe" ..
mingw32-make

32 비트 빌드의 경우 패키지 이름과 경로를 적절히 조정하십시오.