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

Saat menyebarkan aplikasi, Anda juga harus menyebarkan file yang diperlukan untuk mendukungnya. Jika salah satu file ini disediakan oleh Microsoft, periksa apakah Anda diizinkan untuk mendistribusikannya kembali. Anda akan menemukan tautan ke ketentuan lisensi Visual Studio di IDE. Gunakan tautan Istilah lisensi dalam kotak dialog Tentang Microsoft Visual Studio. Atau, unduh ELA dan lisensi 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 yang dapat didistribusikan untuk Microsoft Visual Studio 2022

Untuk melihat "daftar REDIST" yang dirujuk di bagian "Kode yang Dapat Didistribusikan" dari Ketentuan Lisensi Perangkat Lunak Microsoft Visual Studio 2019, lihat File Kode yang Dapat Didistribusikan untuk Microsoft Visual Studio 2019

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

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

Untuk informasi selengkapnya tentang file yang dapat didistribusikan ulang, lihat Menentukan 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.exedan vc_redist.x86.exe. Di Visual Studio 2015, 2017, dan 2019, mereka juga tersedia dengan nama vcredist_x86.exe, , vcredist_x64.exedan (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. Di Visual Studio 2022, file yang dapat didistribusikan ulang ada di %VCINSTALLDIR%Redist\MSVC\v143 folder . Dalam versi terbaru Visual Studio 2019, Anda akan menemukan file yang dapat didistribusikan ulang di %VCINSTALLDIR%Redist\MSVC\v142 folder . Di Visual Studio 2017 dan Visual Studio 2019, visual Studio juga ditemukan di %VCToolsRedistDir%. Di Visual Studio 2015, file-file ini dapat ditemukan di , di %VCINSTALLDIR%redist\<locale>mana <locale> merupakan lokal paket yang dapat didistribusikan ulang.

Di Visual Studio 2022 dan 2019, file modul penggabungan adalah bagian dari komponen opsional yang dapat diinstal bernama MSM yang Dapat Didistribusikan Ulang versi> C++ <di Alat Penginstal Visual Studio. Modul penggabungan diinstal secara default sebagai bagian dari penginstalan C++ di Visual Studio 2017 dan Visual Studio 2015. Saat diinstal di Visual Studio 2022, Anda akan 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 berada di %VCINSTALLDIR%Redist\MSVC\v142\MergeModules. Di Visual Studio 2019 dan Visual Studio 2017, visual Studio 2017 juga ditemukan di %VCToolsRedistDir%MergeModules. Di 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 tentang 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 akan diinstal. Di Visual Studio 2015 atau yang lebih baru, paket Redistributable menampilkan pesan kesalahan yang menyatakan bahwa penyiapan gagal. Jika paket dijalankan dengan menggunakan /quiet bendera, tidak ada pesan kesalahan yang ditampilkan. Dalam kedua kasus, kesalahan dicatat oleh alat penginstal Microsoft, 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 yang diinstal saat ini disimpan di HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\VisualStudio\14.0\VC\Runtimes\{x86|x64|arm64} kunci. Nomor versi adalah 14.0 untuk Visual Studio 2015, 2017, 2019, dan 2022 karena Redistributable terbaru kompatibel dengan versi sebelumnya kembali ke 2015. Kuncinya adalah arm64, x86, atau x64 tergantung pada versi vcredist yang diinstal untuk platform. (Anda perlu memeriksa di bawah Wow6432Node subkunji hanya jika Anda menggunakan Regedit untuk melihat versi paket x86 yang diinstal pada platform x64.) Nomor versi disimpan dalam REG_SZ nilai string dan juga dalam kumpulan Majornilai , , MinorBld, dan RbldREG_DWORD .Version Untuk menghindari kesalahan pada waktu penginstalan, Anda harus melewati penginstalan paket Redistributable jika versi yang saat ini diinstal lebih baru.

Opsi baris perintah untuk paket Redistributable

Visual C++ Redistributable mendukung beberapa opsi baris perintah. Opsi /?, /h, atau /help menampilkan dialog pop-up yang mencantumkan opsi yang tersedia. Anda dapat menentukan /install untuk menginstal, /repair memperbaiki, atau /uninstall menghapus instalasi Redistributable. Opsi /layout 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 /passive opsi, yang menampilkan kemajuan, tetapi tidak memerlukan interaksi pengguna. Anda juga dapat menentukan /quiet opsi, yang tidak menampilkan UI apa pun atau memerlukan interaksi pengguna apa pun. Opsi /norestart menekan setiap upaya untuk memulai ulang. Secara default, file log dibuat di %TEMP%. Anda dapat menggunakan /log filename.txt 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 (.msm 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 Redistributable memungkinkan Microsoft untuk melayani file pustaka runtime secara independen. Dan, penghapusan instalan aplikasi Anda tidak dapat memengaruhi aplikasi lain yang juga menggunakan penyebaran pusat. Saat Anda menggunakan paket Redistributable untuk penyebaran pusat, Anda tidak bertanggung jawab untuk melacak dan memelihara pustaka runtime. Jika tidak, pembaruan ke file pustaka runtime mengharuskan Anda memperbarui dan menyebarkan ulang alat penginstal Anda .msi . 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 run-time

Jika Windows tidak dapat menemukan salah satu DLL pustaka Redistributable yang diperlukan oleh aplikasi Anda, ini mungkin menampilkan pesan yang mirip dengan: "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 Redistributable disebarkan dengan benar pada sistem target. Untuk informasi selengkapnya, lihat Memahami Dependensi Aplikasi Visual C++.

Mendistribusikan ulang dengan menggunakan modul penggabungan
Menjelaskan cara menggunakan modul penggabungan Visual C++ Redistributable untuk menginstal pustaka runtime Visual C++ sebagai DLL bersama di %windir%\system32\ folder.

Mendistribusikan ulang Kontrol ActiveX C++ Visual
Menjelaskan cara mendistribusikan ulang aplikasi yang menggunakan Kontrol ActiveX.

Mendistribusikan ulang Pustaka MFC
Menjelaskan cara mendistribusikan ulang aplikasi yang menggunakan MFC.

Mendistribusikan ulang aplikasi ATL
Menjelaskan cara mendistribusikan ulang aplikasi yang menggunakan ATL. Di Visual Studio 2012 dan yang lebih baru, tidak diperlukan pustaka ATL.

Contoh Penyebaran
Tautan ke contoh yang menunjukkan cara menyebarkan aplikasi Visual C++.

Mengaktifkan Aplikasi Desktop
Memperkenalkan konsep dan teknologi penyebaran Visual C++.