]>
Commit | Line | Data |
---|---|---|
1e59de90 TL |
1 | # Vcpkg: 개요\r |
2 | \r | |
3 | Vcpkg는 Windows, Linux 및 MacOS에서 C 및 C++ 라이브러리를 관리하는 데 도움이 됩니다.\r | |
4 | 이 툴과 생태계는 지속적으로 진화하고 있으며 항상 기여해 주셔서 감사합니다!\r | |
5 | \r | |
6 | 이전에 vcpkg를 사용한 적이 없거나 vcpkg를 사용하는 방법을 알고 싶을 경우,\r | |
7 | vcpkg 사용을 시작하는 방법은 [시작하기](#시작하기) 섹션을 확인하세요.\r | |
8 | \r | |
9 | 사용 가능한 명령어에 대한 간단한 설명을 보려면 vcpkg를 설치 한 후 `vcpkg help` 또는 `vcpkg help [command]` 명령어로 명령어 별 도움말을 볼 수 있습니다.\r | |
10 | \r | |
11 | * Github: [https://github.com/microsoft/vcpkg](https://github.com/microsoft/vcpkg)\r | |
12 | * Slack: [https://cppalliance.org/slack/](https://cppalliance.org/slack/), #vcpkg 채널\r | |
13 | * Discord: [\#include \<C++\>](https://www.includecpp.org), #🌏vcpkg 채널\r | |
14 | * Docs: [Documentation](docs/README.md)\r | |
15 | \r | |
16 | [![Build Status](https://dev.azure.com/vcpkg/public/_apis/build/status/microsoft.vcpkg.ci?branchName=master)](https://dev.azure.com/vcpkg/public/_build/latest?definitionId=29&branchName=master)\r | |
17 | \r | |
18 | # 목차\r | |
19 | \r | |
20 | - [Vcpkg: 개요 둘러보기](#vcpkg-개요)\r | |
21 | - [목차](#목차)\r | |
22 | - [시작하기](#시작하기)\r | |
23 | - [빠르게 시작하기: 원도우](#빠르게-시작하기-원도우)\r | |
24 | - [빠르게 시작하기: 유닉스](#빠르게-시작하기-유닉스)\r | |
25 | - [리눅스 개발자 도구 설치하기](#리눅스-개발자-도구-설치하기)\r | |
26 | - [macOS 개발자 도구 설치하기](#macos-개발자-도구-설치하기)\r | |
27 | - [10.15버전 이전 macOS에 GCC 설치하기](#1015버전-이전-macos에-gcc-설치하기)\r | |
28 | - [CMake와 함께 vcpkg 사용](#cmake와-함께-vcpkg-사용)\r | |
29 | - [Visual Studio Code와 CMake Tools](#visual-studio-code와-cmake-tools)\r | |
30 | - [Visual Studio CMake 프로젝트와 Vcpkg](#visual-studio-cmake-프로젝트와-vcpkg)\r | |
31 | - [Vcpkg와 CLion](#vcpkg와-clion)\r | |
32 | - [서브모듈로서의 Vcpkg](#서브모듈로서의-vcpkg)\r | |
33 | - [탭 완성/자동 완성](#탭-완성/자동-완성)\r | |
34 | - [예제](#예제)\r | |
35 | - [기여](#기여)\r | |
36 | - [라이선스](#라이선스)\r | |
37 | - [데이터 수집](#데이터-수집)\r | |
38 | \r | |
39 | # 시작하기\r | |
40 | \r | |
41 | 먼저, 사용하는 운영체제에 따라 빠르게 시작하기 문서를 따라가세요.\r | |
42 | [윈도우](#빠르게-시작하기-윈도우) 또는 [macOS 그리고 Linux](#빠르게-시작하기-유닉스).\r | |
43 | \r | |
44 | 더 많은 정보를 얻고 싶다면, [패키지 설치 및 사용][getting-started:using-a-package] 문서를 참고하세요.\r | |
45 | 만약 필요한 라이브러리가 vcpkg 카탈로그에 없는 경우, vcpkg 팀이나 커뮤니티가 볼 수 있는\r | |
46 | [GitHub 저장소에서 이슈를 열 수 있습니다][contributing:submit-issue]\r | |
47 | 또한 잠재적으로 vcpkg에 포트가 추가될 것 입니다.\r | |
48 | \r | |
49 | vcpkg를 설치하고 작동 한 후, \r | |
50 | 셸에 [탭 완성/자동 완성](#탭-완성/자동-완성)을 추가 할 수 있습니다.\r | |
51 | \r | |
52 | 마지막으로, vcpkg의 미래에 관심이 있다면,\r | |
53 | [manifest][getting-started:manifest-spec] 가이드를 확인하세요!\r | |
54 | 이것은 실험적인 기능이며 버그가 있을 수도 있습니다.\r | |
55 | 시도해보고 문제가 있다면 [이슈을 여세요][contributing:submit-issue]!\r | |
56 | \r | |
57 | ## 빠르게 시작하기: 윈도우\r | |
58 | \r | |
59 | 필요조건:\r | |
60 | - Windows 7 이상\r | |
61 | - [Git][getting-started:git]\r | |
62 | - [Visual Studio][getting-started:visual-studio] 영어 언어팩이 설치된 2015 Update 3 버전 이상\r | |
63 | \r | |
64 | 첫번째로, vcpkg 자체를 다운로드하고 부트스트랩합니다; 어디에나 설치할 수 있습니다,\r | |
65 | 하지만 일반적으로 CMake 프로젝트의 하위 모듈로 vcpkg를 사용하는 것이 좋습니다.\r | |
66 | Visual Studio 프로젝트를 위해 전역적으로 설치합니다.\r | |
67 | 설치 위치는 `C:\src\vcpkg` 나 `C:\dev\vcpkg`를 사용할것을 권장합니다. \r | |
68 | 그렇지 않으면 일부 포트 빌드 시스템에서 경로 문제가 발생할 수도 있습니다.\r | |
69 | \r | |
70 | ```cmd\r | |
71 | > git clone https://github.com/microsoft/vcpkg\r | |
72 | > .\vcpkg\bootstrap-vcpkg.bat\r | |
73 | ```\r | |
74 | \r | |
75 | 당신의 프로젝트에 라이브러리를 설치, 실행 시키려면 다음과 같이 작성하세요:\r | |
76 | \r | |
77 | ```cmd\r | |
78 | > .\vcpkg\vcpkg install [packages to install]\r | |
79 | ```\r | |
80 | \r | |
81 | 다음과 같이 `search` 하위 명령어를 사용하여 필요한 라이브러리를 검색 할 수도 있습니다.\r | |
82 | \r | |
83 | ```cmd\r | |
84 | > .\vcpkg\vcpkg search [search term]\r | |
85 | ```\r | |
86 | \r | |
87 | Visual Studio에서 vcpkg를 사용하려면\r | |
88 | 다음 명령을 실행합니다 (관리자 권한이 필요할 수도 있습니다):\r | |
89 | \r | |
90 | ```cmd\r | |
91 | > .\vcpkg\vcpkg integrate install\r | |
92 | ```\r | |
93 | \r | |
94 | \r | |
95 | 그런 다음, 이제 CMake가 아닌 새 프로젝트를 만들 수 있습니다. (또는 기존 프로젝트를 열 수 있습니다)\r | |
96 | 설치된 모든 라이브러리는 즉시 `# include` 될 준비가 되어 추가 구성없이 프로젝트에서 사용할 수 있습니다.\r | |
97 | \r | |
98 | Visual Studio에서 CMake를 사용하는 경우,\r | |
99 | [여기를 보세요](#visual-studio-code와-cmake-tools).\r | |
100 | \r | |
101 | IDE 외부에서 CMake와 함께 vcpkg를 사용하려면,\r | |
102 | 툴체인 파일을 사용할 수 있습니다:\r | |
103 | \r | |
104 | ```cmd\r | |
105 | > cmake -B [build directory] -S . -DCMAKE_TOOLCH\r | |
106 | AIN_FILE=[path to vcpkg]/scripts/buildsystems/vcpkg.cmake\r | |
107 | > cmake --build [build directory]\r | |
108 | ```\r | |
109 | \r | |
110 | CMake와 라이브러리를 사용하려면 `find_package` 등이 필요합니다.\r | |
111 | IDE에서 CMake 사용에 대한 자세한 내용은 [CMake 섹션](#cmake와-함께-vcpkg-사용)을 확인하세요.\r | |
112 | \r | |
113 | \r | |
114 | Visual Studio Code를 포함한 다른 툴의 경우\r | |
115 | [통합 가이드][getting-started:integration]을 확인하세요.\r | |
116 | \r | |
117 | ## 빠르게 시작하기: 유닉스\r | |
118 | \r | |
119 | Linux에서의 필요조건:\r | |
120 | - [Git][getting-started:git]\r | |
121 | - [g++][getting-started:linux-gcc] >= 6\r | |
122 | \r | |
123 | macOS에서의 필요조건:\r | |
124 | - [Apple Developer Tools][getting-started:macos-dev-tools]\r | |
125 | - macOS 10.14이나 아래 버전에서는 다음 도구들도 필요합니다:\r | |
126 | - [Homebrew][getting-started:macos-brew]\r | |
127 | - [g++][getting-started:macos-gcc] >= 6 from Homebrew\r | |
128 | \r | |
129 | 첫번째로, vcpkg 자체를 다운로드하고 부트스트랩합니다; 어디에나 설치할 수 있습니다,\r | |
130 | 하지만 일반적으로 CMake 프로젝트의 하위 모듈로 vcpkg를 사용하는 것이 좋습니다.\r | |
131 | \r | |
132 | ```sh\r | |
133 | $ git clone https://github.com/microsoft/vcpkg\r | |
134 | $ ./vcpkg/bootstrap-vcpkg.sh\r | |
135 | ```\r | |
136 | \r | |
137 | 당신의 프로젝트에 라이브러리를 설치, 실행 시키려면 다음과 같이 작성하세요:\r | |
138 | \r | |
139 | ```sh\r | |
140 | $ ./vcpkg/vcpkg install [packages to install]\r | |
141 | ```\r | |
142 | \r | |
143 | 다음과 같이 `search` 하위 명령어를 사용하여 필요한 라이브러리를 검색 할 수도 있습니다.\r | |
144 | \r | |
145 | ```sh\r | |
146 | $ ./vcpkg/vcpkg search [search term]\r | |
147 | ```\r | |
148 | \r | |
149 | CMake에서 vcpkg를 사용하려면 툴체인 파일을 사용할 수 있습니다\r | |
150 | ```sh\r | |
151 | $ cmake -B [build directory] -S . -DCMAKE_TOOLCHAIN_FILE=[path to vcpkg]/scripts/buildsystems/vcpkg.cmake\r | |
152 | $ cmake --build [build directory]\r | |
153 | ```\r | |
154 | \r | |
155 | CMake와 라이브러리를 사용하려면 `find_package` 등이 필요합니다.\r | |
156 | CMake 및 CMake Tools for VSCode에서 vcpkg를 가장 잘 사용하는 방법에 대한 자세한 내용은 \r | |
157 | [CMake 섹션](#cmake와-함께-vcpkg-사용)을 확인하세요.\r | |
158 | \r | |
159 | 다른 툴에 대해서는 [통합 가이드][getting-started:integration]을 확인하세요.\r | |
160 | ## 리눅스 개발자 도구 설치하기\r | |
161 | \r | |
162 | 리눅스의 다양한 배포판에는 다양한 패키지가 있습니다.\r | |
163 | 설치 필요:\r | |
164 | \r | |
165 | -Debian, Ubuntu, popOS 및 기타 Debian 기반 배포판:\r | |
166 | \r | |
167 | ```sh\r | |
168 | $ sudo apt-get update\r | |
169 | $ sudo apt-get install build-essential tar curl zip unzip\r | |
170 | ```\r | |
171 | \r | |
172 | - CentOS\r | |
173 | \r | |
174 | ```sh\r | |
175 | $ sudo yum install centos-release-scl\r | |
176 | $ sudo yum install devtoolset-7\r | |
177 | $ scl enable devtoolset-7 bash\r | |
178 | ```\r | |
179 | \r | |
180 | 다른 배포판의 경우 g++ 6 이상의 버전을 설치해야합니다.\r | |
181 | 특정 배포판에 대한 지침을 추가하려면\r | |
182 | [PR을 열어주세요][contributing:submit-pr]!\r | |
183 | \r | |
184 | ## macOS 개발자 도구 설치하기\r | |
185 | \r | |
186 | macOS 10.15에서는 터미널에서 다음 명령어를 실행하시면 됩니다.\r | |
187 | \r | |
188 | ```sh\r | |
189 | $ xcode-select --install\r | |
190 | ```\r | |
191 | \r | |
192 | 그런 다음 나타나는 창에 나타나는 메시지를 따르세요.\r | |
193 | \r | |
194 | macOS 10.14 및 이전 버전에서는 homebrew에서 g++도 설치해야합니다.\r | |
195 | 다음 섹션의 지침을 따르세요.\r | |
196 | \r | |
197 | ### 10.15버전 이전 macOS에 GCC 설치하기\r | |
198 | \r | |
199 | 이번 섹션은 10.15 이전의 macOS 버전을 사용하는 경우에만 필요합니다.\r | |
200 | homebrew를 설치하는 것은 매우 쉽습니다. 자세한 내용은 <brew.sh>를 확인하세요.\r | |
201 | 가장 간단하게 다음 명령어을 실행합니다.\r | |
202 | \r | |
203 | ```sh\r | |
204 | $ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"\r | |
205 | ```\r | |
206 | \r | |
207 | 그런 다음 최신 버전의 gcc를 설치하시려면 다음 명령어를 실행하십시오.\r | |
208 | \r | |
209 | ```sh\r | |
210 | $ brew install gcc\r | |
211 | ```\r | |
212 | \r | |
213 | 그런다음 [빠른 시작 가이드](#빠르게-시작하기-유닉스)와 함께 vcpkg를 부트스트랩 할 수 있습니다.\r | |
214 | \r | |
215 | ## CMake와 함께 vcpkg 사용\r | |
216 | \r | |
217 | CMake와 함께 vcpkg를 사용하는 경우, 다음과 같이 따라해 보세요\r | |
218 | \r | |
219 | ### Visual Studio Code와 CMake Tools\r | |
220 | \r | |
221 | 작업 공간 `settings.json` 파일에 다음을 추가하면\r | |
222 | CMake 도구는 라이브러리에 자동으로 vcpkg를 사용합니다.\r | |
223 | \r | |
224 | ```json\r | |
225 | {\r | |
226 | "cmake.configureSettings": {\r | |
227 | "CMAKE_TOOLCHAIN_FILE": "[vcpkg root]/scripts/buildsystems/vcpkg.cmake"\r | |
228 | }\r | |
229 | }\r | |
230 | ```\r | |
231 | \r | |
232 | ### Visual Studio CMake 프로젝트와 Vcpkg\r | |
233 | \r | |
234 | CMake 설정 편집기를 열고 'CMake toolchain file'에서\r | |
235 | vcpkg 툴체인 파일에 경로를 추가합니다.\r | |
236 | \r | |
237 | ```\r | |
238 | [vcpkg root]/scripts/buildsystems/vcpkg.cmake\r | |
239 | ```\r | |
240 | \r | |
241 | ### Vcpkg와 CLion\r | |
242 | \r | |
243 | Toolchains settings을 엽니다.\r | |
244 | (File > Settings on Windows and Linux, CLion > Preferences on macOS),\r | |
245 | 그리고 Cmake 세팅을 엽니다 (Build, Execution, Deployment > CMake).\r | |
246 | 마지막으로 `CMake options`에서 다음 줄을 추가합니다.\r | |
247 | \r | |
248 | ```\r | |
249 | -DCMAKE_TOOLCHAIN_FILE=[vcpkg root]/scripts/buildsystems/vcpkg.cmake\r | |
250 | ```\r | |
251 | \r | |
252 | 각 프로필에 이것을 추가해야합니다.\r | |
253 | \r | |
254 | ### 서브모듈로서의 Vcpkg\r | |
255 | \r | |
256 | 프로젝트의 하위 모듈로 vcpkg를 사용하는 경우\r | |
257 | cmake 호출에`CMAKE_TOOLCHAIN_FILE`을 전달하는 대신 첫 번째 `project ()` 호출 전에 CMakeLists.txt에 다음을 추가 할 수 있습니다.\r | |
258 | \r | |
259 | ```cmake\r | |
260 | set(CMAKE_TOOLCHAIN_FILE ${CMAKE_CURRENT_SOURCE_DIR}/vcpkg/scripts/buildsystems/vcpkg.cmake\r | |
261 | CACHE STRING "Vcpkg toolchain file")\r | |
262 | ```\r | |
263 | \r | |
264 | 이렇게 하면 `CMAKE_TOOLCHAIN_FILE`을 직접 전달하여 구성-빌드 단계가 약간 더 쉬워지지만 \r | |
265 | 사람들이 vcpkg를 사용하지 못하게 됩니다.\r | |
266 | \r | |
267 | [getting-started:using-a-package]: docs/examples/installing-and-using-packages.md\r | |
268 | [getting-started:integration]: docs/users/integration.md\r | |
269 | [getting-started:git]: https://git-scm.com/downloads\r | |
270 | [getting-started:cmake-tools]: https://marketplace.visualstudio.com/items?itemName=ms-vscode.cmake-tools\r | |
271 | [getting-started:linux-gcc]: #installing-linux-developer-tools\r | |
272 | [getting-started:macos-dev-tools]: #installing-macos-developer-tools\r | |
273 | [getting-started:macos-brew]: #installing-gcc-on-macos\r | |
274 | [getting-started:macos-gcc]: #installing-gcc-on-macos\r | |
275 | [getting-started:visual-studio]: https://visualstudio.microsoft.com/\r | |
276 | [getting-started:manifest-spec]: docs/specifications/manifests.md\r | |
277 | \r | |
278 | # 탭 완성/자동 완성\r | |
279 | \r | |
280 | `vcpkg`는 powershell과 bash 모두에서 명령, 패키지 이름 및 옵션의 자동 완성을 지원합니다.\r | |
281 | 선택한 셸에서 탭 완성을 활성화하려면 다음 명령어를 실행합니다.\r | |
282 | \r | |
283 | ```pwsh\r | |
284 | > .\vcpkg integrate powershell\r | |
285 | ```\r | |
286 | \r | |
287 | 혹은\r | |
288 | \r | |
289 | ```sh\r | |
290 | $ ./vcpkg integrate bash\r | |
291 | ```\r | |
292 | \r | |
293 | 사용하는 셸에 따라 콘솔을 다시 시작세요.\r | |
294 | \r | |
295 | # 예제\r | |
296 | \r | |
297 | 구체적인 연습은 [문서](docs/README.md)를 참고하세요,\r | |
298 | including [패키지 설치 및 사용](docs/examples/installing-and-using-packages.md),\r | |
299 | [zip 파일에서 새 패키지 추가](docs/examples/packaging-zipfiles.md),\r | |
300 | 및 [GitHub 저장소에서 새 패키지 추가](docs/examples/packaging-github-repos.md).\r | |
301 | \r | |
302 | 이제 ReadTheDocs에서 온라인으로 문서를 사용할 수도 있습니다: <https://vcpkg.readthedocs.io/>!\r | |
303 | \r | |
304 | [4분짜리 데모 영상을 보세요](https://www.youtube.com/watch?v=y41WFKbQFTw).\r | |
305 | \r | |
306 | # 기여\r | |
307 | \r | |
308 | Vcpkg는 오픈소스 프로젝트입니다, 따라서 여러분의 기여로 만들어 졌습니다. \r | |
309 | 기여할 수 있는 몇 가지 방법은 다음과 같습니다:\r | |
310 | \r | |
311 | * vcpkg 또는 기존 패키지의 [문제 제출][contributing:submit-issue] \r | |
312 | * [Submit Fixes and New Packages][contributing:submit-pr]\r | |
313 | \r | |
314 | 자세한 내용은 [컨트리뷰팅 가이드](CONTRIBUTING.md)를 참고하세요.\r | |
315 | \r | |
316 | 이 프로젝트는 [Microsoft Open Source Code of Conduct][contributing:coc]을 채택했습니다.\r | |
317 | 더 많은 정보를 얻고 싶다면 [Code of Conduct FAQ][contributing:coc-faq] 문서를 참고하거나 추가 질문 또는 의견은 이메일 [opencode@microsoft.com](mailto:opencode@microsoft.com)로 보내주세요.\r | |
318 | \r | |
319 | [contributing:submit-issue]: https://github.com/microsoft/vcpkg/issues/new/choose\r | |
320 | [contributing:submit-pr]: https://github.com/microsoft/vcpkg/pulls\r | |
321 | [contributing:coc]: https://opensource.microsoft.com/codeofconduct/\r | |
322 | [contributing:coc-faq]: https://opensource.microsoft.com/codeofconduct/\r | |
323 | \r | |
324 | # 라이선스\r | |
325 | \r | |
326 | 이 저장소의 코드는 [MIT 라이선스](LICENSE.txt)에 따라 라이선스가 부여됩니다.\r | |
327 | \r | |
328 | # 데이터 수집\r | |
329 | \r | |
330 | vcpkg는 사용자 경험을 개선하는 데 도움이 되도록 사용 데이터를 수집합니다.\r | |
331 | Microsoft는 이 정보를 익명으로 수집합니다.\r | |
332 | bootstrap-vcpkg 스크립트를 -disableMetrics를 추가해 다시 실행하여 원격 분석을 옵트아웃 할 수 있습니다.\r | |
333 | 커맨드 라인에서 --disable-metrics를 vcpkg에 전달합니다.\r | |
334 | 또는 VCPKG_DISABLE_METRICS 환경 변수를 설정합니다.\r | |
335 | \r | |
336 | docs/about/privacy.md 에 vcpkg 데이터 수집에 대해 자세히 알아보세요.\r |