Mendistribusikan ulang file Visual C++

Catatan

Apakah Anda di sini karena Anda mencari unduhan salah satu file Visual C++ Runtime? Buka halaman unduhan Visual C++ Redistributable terbaru yang didukung .

File dan lisensi yang dapat didistribusikan ulang

Distribusi paket Visual C++ Runtime Redistributable, modul penggabungan, dan biner individual terbatas pada pengguna Visual Studio berlisensi dan tunduk pada Ketentuan Lisensi Perangkat Lunak Microsoft.

Saat menyebarkan aplikasi, Anda juga harus menyebarkan file yang diperlukan untuk mendukungnya. Jika Microsoft menyediakan salah satu file ini, periksa apakah Anda diizinkan untuk mendistribusikannya kembali. Anda dapat menemukan tautan ke ketentuan lisensi Visual Studio di IDE. Dalam dialog Tentang Microsoft Visual Studio, pilih tautan ketentuan Lisensi. Anda juga dapat mengunduh Syarat dan lisensi Lisensi Perangkat Lunak Microsoft yang relevan dari Visual Studio License Directory.

Untuk melihat "daftar REDIST" yang dirujuk di bagian "Kode yang Dapat Didistribusikan" dari Ketentuan Lisensi Perangkat Lunak Microsoft Visual Studio 2022, lihat file kode Distributable untuk Microsoft Visual Studio 2022.

Untuk informasi selengkapnya tentang file yang dapat didistribusikan ulang, lihat Menentukan pustaka tautan dinamis (DLL) mana yang akan didistribusikan ulang dan Contoh penyebaran.

Temukan file yang dapat didistribusikan ulang

Untuk menyebarkan file yang dapat didistribusikan ulang, Anda dapat menggunakan paket yang dapat didistribusikan ulang yang diinstal oleh Visual Studio. Dalam versi Visual Studio sejak 2017, file-file ini diberi nama vc_redist.arm64.exe, vc_redist.x64.exe, dan vc_redist.x86.exe. Pada Visual Studio 2015, 2017, dan 2019, mereka juga tersedia dengan nama vcredist_x86.exe, vcredist_x64.exe, dan (hanya 2015) vcredist_arm.exe.

Cara term mudah untuk menemukan file yang dapat didistribusikan ulang adalah dengan menggunakan variabel lingkungan yang diatur dalam prompt perintah pengembang. Pada Visual Studio 2022, file yang dapat didistribusikan ulang berada di folder %VCINSTALLDIR%Redist\MSVC\v143. Dalam versi terbaru Visual Studio 2019, Anda dapat menemukan file yang dapat didistribusikan ulang di folder %VCINSTALLDIR%Redist\MSVC\v142. Dalam Visual Studio 2017 dan Visual Studio 2019, file juga ditemukan di %VCToolsRedistDir%. Pada Visual Studio 2015, Anda dapat menemukan file-file ini di %VCINSTALLDIR%redist\<locale>, di mana <locale> adalah lokal paket yang dapat didistribusikan ulang.

Pada Visual Studio 2022 dan 2019, file modul penggabungan adalah bagian dari komponen opsional yang dapat diinstal bernama Visual C++ <version> Modul penggabungan Redistributable di Penginstal Visual Studio. Modul penggabungan diinstal secara default sebagai bagian dari penginstalan C++ pada Visual Studio 2017 dan Visual Studio 2015. Saat diinstal pada Visual Studio 2022, Anda dapat menemukan modul penggabungan yang dapat didistribusikan ulang di %VCINSTALLDIR%Redist\MSVC\v143\MergeModules.

Dalam versi terbaru Visual Studio 2019, modul penggabungan yang dapat didistribusikan ulang ditemukan di %VCINSTALLDIR%Redist\MSVC\v142\MergeModules. Pada Visual Studio 2019 dan Visual Studio 2017, mereka juga ditemukan di %VCToolsRedistDir%MergeModules. Pada Visual Studio 2015, mereka ditemukan di Program Files [(x86)]\Common Files\Merge Modules.

Menginstal paket yang dapat didistribusikan ulang

Paket Visual C++ Redistributable menginstal dan mendaftarkan semua pustaka Visual C++. Jika Anda menggunakannya, jalankan sebagai prasyarat pada sistem target sebelum Anda menginstal aplikasi Anda. Kami menyarankan agar Anda menggunakan paket ini untuk penyebaran Anda karena mengaktifkan pembaruan otomatis pustaka Visual C++. Untuk contoh yang menunjukkan cara menggunakan paket ini, lihat Panduan: Menyebarkan aplikasi Visual C++ dengan menggunakan paket Visual C++ Redistributable.

Setiap paket Visual C++ Redistributable memeriksa keberadaan versi yang lebih baru pada komputer. Jika versi yang lebih baru ditemukan, paket tidak diinstal. Pada Visual Studio 2015 atau yang lebih baru, paket yang dapat didistribusikan ulang menampilkan pesan kesalahan yang menyatakan bahwa penyiapan gagal. Jika paket menggunakan bendera untuk dijalankan, tidak ada pesan kesalahan yang muncul. Dalam kedua kasus, alat penginstal Microsoft mencatat kesalahan, dan hasil kesalahan dikembalikan ke pemanggil.

Di Visual Studio 2015 dan yang lebih baru, Anda dapat menghindari kesalahan ini dengan memeriksa registri untuk mengetahui apakah versi yang lebih baru diinstal. Nomor versi terpasang saat ini disimpan di dalam kunci.

Nomor versi adalah 14.0 untuk Visual Studio 2015, 2017, 2019, dan 2022 karena paket yang dapat didistribusikan ulang terbaru memiliki kompatibilitas biner dengan versi-versi sebelumnya hingga kembali ke tahun 2015. Kuncinya adalah , , atau tergantung pada versi yang diinstal untuk platform. (Anda perlu memeriksa di bawah subkey hanya jika Anda menggunakan Regedit untuk melihat versi paket x86 yang diinstal pada platform x64.)

Nomor versi disimpan dalam nilai string dan juga dalam kumpulan nilai , , , dan . Untuk menghindari kesalahan pada waktu penginstalan, Anda harus melewati penginstalan paket yang dapat didistribusikan ulang jika versi yang saat ini diinstal lebih baru.

Opsi baris perintah untuk paket yang dapat didistribusikan ulang

Visual C++ Redistributable mendukung beberapa opsi baris perintah. Opsi , , atau menampilkan dialog yang mencantumkan opsi yang tersedia. Anda dapat menentukan untuk menginstal, memperbaiki, atau menghapus instalasi Redistributable. Opsi menyalin konten lengkap Redistributable di direktori saat ini.

Secara default, Redistributable menginstal kontennya dan meminta informasi kepada pengguna dan apakah akan memulai ulang setelah penginstalan. Anda dapat menentukan opsi, yang menampilkan kemajuan tetapi tidak memerlukan interaksi pengguna. Anda juga dapat menentukan opsi, yang tidak menampilkan antarmuka pengguna atau memerlukan interaksi pengguna apa pun. Opsi menekan setiap upaya untuk memulai ulang. Secara default, file log dibuat di . Anda dapat menggunakan untuk log ke file tertentu.

Contoh perintah ini menginstal x64 Redistributable. Ini menunjukkan kemajuan penginstalan tetapi tidak memerlukan interaksi pengguna atau menghidupkan ulang:

vc_redist.x64.exe /install /passive /norestart

Menginstal modul penggabungan yang dapat didistribusikan ulang

Penting

Modul penggabungan ( file) untuk file Visual C++ Redistributable tidak digunakan lagi. Kami tidak menyarankan Anda menggunakannya untuk penyebaran aplikasi. Sebagai gantinya, kami merekomendasikan penyebaran pusat paket Visual C++ Redistributable. Penyebaran pusat oleh paket yang dapat didistribusikan ulang memungkinkan Microsoft untuk melayani file pustaka runtime secara independen. Penghapusan instalasi aplikasi Anda tidak dapat memengaruhi aplikasi lain yang juga menggunakan penyebaran pusat.

Saat Anda menggunakan paket yang dapat didistribusikan ulang untuk penyebaran pusat, Anda tidak bertanggung jawab untuk melacak dan memelihara pustaka runtime. Sebagai alternatif, jika ada pembaruan pada file pustaka runtime, Anda diharuskan memperbarui dan menyebarkan ulang penginstal Anda. Aplikasi Anda mungkin rentan terhadap bug atau masalah keamanan hingga Anda melakukannya.

Modul penggabungan yang dapat didistribusikan ulang harus disertakan dalam paket penginstal Windows (atau paket penginstalan serupa) yang Anda gunakan untuk menyebarkan aplikasi Anda. Untuk informasi selengkapnya, lihat Mendistribusikan ulang dengan menggunakan modul penggabungan. Misalnya, lihat Panduan: Menyebarkan aplikasi Visual C++ dengan menggunakan proyek penyiapan.

Menginstal file yang dapat didistribusikan ulang individual

Dimungkinkan juga untuk langsung menginstal DLL Redistributable di folder lokal aplikasi. Folder lokal aplikasi adalah folder yang berisi file aplikasi yang dapat dieksekusi. Untuk alasan layanan, kami tidak menyarankan Anda menggunakan lokasi penginstalan ini.

Potensi kesalahan saat runtime

Jika Windows tidak dapat menemukan salah satu DLL Redistributable yang diperlukan oleh aplikasi Anda, mungkin menampilkan pesan yang mirip dengan yang satu ini: "Aplikasi ini gagal dimulai karena library.dll tidak ditemukan. Menginstal ulang aplikasi dapat memperbaiki masalah ini."

Untuk mengatasi kesalahan semacam ini, pastikan alat penginstal aplikasi Anda dibuat dengan benar. Verifikasi bahwa pustaka yang dapat didistribusikan ulang disebarkan dengan benar pada sistem target. Untuk informasi selengkapnya, lihat Memahami dependensi aplikasi Visual C++.

Konten terkait

• Mendistribusikan ulang menggunakan modul penggabungan menjelaskan cara memakai modul penggabungan Visual C++ Redistributable untuk memasang pustaka Runtime Visual C++ sebagai DLL bersama di folder tersebut.
• Mendistribusikan ulang kontrol Visual C++ ActiveX menjelaskan cara mendistribusikan ulang aplikasi yang menggunakan kontrol ActiveX.
• Mendistribusikan ulang Pustaka Microsoft Foundation Class (MFC) menjelaskan cara mendistribusikan ulang aplikasi yang menggunakan MFC.
• Mendistribusikan ulang aplikasi Active Template Library (ATL) menjelaskan cara mendistribusikan ulang aplikasi yang menggunakan ATL. Pada Visual Studio 2012 dan yang lebih baru, tidak diperlukan pustaka ATL.
• Contoh penerapan merujuk ke contoh yang menunjukkan cara menerapkan aplikasi Visual C++.
• Menyebarkan aplikasi desktop memperkenalkan konsep dan teknologi penyebaran Visual C++.
• Tautan ke unduhan Visual C++ Redistributable terbaru yang didukung.