Bagikan melalui

Penembolokan Biner

Sebagian besar port di registri publik vcpkg dibangun dari sumber. Dengan membangun dari sumber, vcpkg dapat memastikan kompatibilitas maksimum dengan menggunakan lingkungan yang sama, alat build, bendera kompilator, bendera linker, dan konfigurasi lain yang Anda gunakan dalam proyek Anda untuk membangun dependensi Anda.

Saat penyimpanan sementara biner diaktifkan, setelah setiap paket dibuat dari sumber, vcpkg membuat paket biner. Paket biner menyimpan hasil build dari paket: biner, file integrasi sistem build, dokumentasi penggunaan, lisensi, dan file lainnya. Jika eksekusi nanti memerlukan paket cache untuk diinstal, vcpkg menentukan apakah akan memulihkan paket biner yang di-cache atau memicu build dari sumber.

Dengan cara ini, penembolokan biner mengurangi dampak kelemahan berikut dari kompilasi langsung dari sumber.

  • Upaya yang terulang: Dengan mengurangi berapa kali paket perlu dikompilasi dari sumber.
  • Waktu build yang lama: Memulihkan paket biner biasanya merupakan operasi yang sangat cepat yang membutuhkan waktu beberapa detik untuk diselesaikan.

Penembolokan biner sangat efektif dalam skenario CI di mana kontainer sementara atau agen build memaksa vcpkg untuk bekerja dengan clean-slate setiap kali. Dengan menggunakan cache biner berbasis cloud (seperti Paket GitHub atau Artefak Azure DevOps), Anda dapat mempertahankan paket biner di antara eksekusi untuk memastikan kecepatan maksimum karena pembangunan ulang hanya terjadi saat Anda membuat perubahan pada dependensi atau konfigurasi Anda.

Petunjuk / Saran

Disarankan untuk membuat cache biner dengan izin baca dan tulis untuk setiap alur atau alur kerja integrasi berkelanjutan. Pengembang individu harus memiliki akses baca-saja ke cache biner yang diproduksi CI.

Cache biner dapat dihosting di berbagai lingkungan. Bentuk paling dasar dari cache biner adalah folder pada komputer lokal atau berbagi file jaringan. Cache juga dapat disimpan di umpan NuGet apa pun (seperti Paket GitHub atau Artefak Azure DevOps), Azure Blob Storage, Google Cloud Storage, dan banyak layanan lainnya.

Jika penyedia CI Anda menawarkan fungsi "penyimpanan cache" asli, disarankan untuk menggunakan penyimpanan cache biner vcpkg dan metode asli untuk mendapatkan hasil paling optimal.

Menggunakan kembali cache biner untuk pengembangan

Meskipun tidak direkomendasikan sebagai mekanisme distribusi biner, penyimpanan sementara biner dapat digunakan untuk memanfaatkan kembali output build dari beberapa sistem. Misalnya, pengembang dapat menggunakan paket biner yang diproduksi oleh CI yang dijalankan pada komputer lokal mereka. Untuk metode lain untuk menggunakan kembali dan mengintegrasikan biner yang diproduksi vcpkg, lihat vcpkg export.

Misalnya, Anda dapat mengonfigurasi umpan NuGet yang dihosting di Azure Artifacts untuk menerima paket biner yang dibangun dari alur CI Anda dan menggunakannya kembali di lingkungan pengembangan.

Anda harus mengonfigurasi umpan Azure Artifacts Anda untuk memberikan izin baca dan tulis ke alur Azure DevOps Anda serta memberikan izin baca-saja untuk host di tim pengembangan Anda.

Cache biner default

Penyimpanan sementara biner diaktifkan secara default dengan files penyedia pada lokasi valid pertama:

  • Windows
  1. %VCPKG_DEFAULT_BINARY_CACHE%
  2. %LOCALAPPDATA%\vcpkg\archives
  3. %APPDATA%\vcpkg\archives
  • Non-Windows
  1. $VCPKG_DEFAULT_BINARY_CACHE
  2. $XDG_CACHE_HOME/vcpkg/archives
  3. $HOME/.cache/vcpkg/archives

Bantuan dalam alat yang terbatas tersedia melalui vcpkg help binarycaching.

Pengelolaan Cache Biner hanya mencakup biner yang Anda bangun. Untuk menyimpan file sumber dan alat bawaan, lihat Penembolokan Aset.

Langkah selanjutnya

Baca tutorial untuk mempelajari cara menyiapkan cache biner dan referensi sintaks konfigurasi:

  • Last updated on