Mengkonsumsi pustaka dan komponen
Proyek C++ sering kali perlu memanggil fungsi atau mengakses data dalam file biner seperti pustaka statis (file LIB), DLL, komponen Windows Runtime, komponen COM, atau rakitan .NET. Dalam kasus ini, Anda harus mengonfigurasi proyek sehingga dapat menemukan biner tersebut pada waktu build. Langkah-langkah spesifik tergantung pada jenis proyek Anda, jenis biner, dan apakah biner dibangun dalam solusi yang sama dengan proyek Anda.
Mengonsumsi pustaka yang diunduh melalui vcpkg
Untuk menggunakan pustaka yang telah Anda unduh dengan menggunakan manajer paket vcpkg , Anda dapat mengabaikan instruksi di bawah ini. Untuk informasi selengkapnya, lihat:
- vcpkg dalam proyek CMake
- Menginstal dan menggunakan paket dengan CMake di Visual Studio
- vcpkg dalam proyek MSBuild
- Tutorial: Menginstal dan menggunakan paket dengan MSBuild di Visual Studio
Mengkonsumsi pustaka statis
Jika proyek pustaka statis Anda dibangun dalam solusi yang sama:
- #include file header untuk pustaka statis menggunakan tanda kutip. Dalam solusi umum, jalur dimulai dengan
../<library project name>
. IntelliSense akan membantu Anda menemukannya. - Tambahkan referensi ke proyek pustaka statis. Klik kanan Referensi di bawah simpul proyek aplikasi di Penjelajah Solusi dan pilih Tambahkan Referensi.
Jika pustaka statis bukan bagian dari solusi:
- Klik kanan pada simpul proyek aplikasi di Penjelajah Solusi lalu pilih Properti.
- Di halaman properti Direktori VC++, tambahkan jalur ke direktori yang berisi file LIB ke Jalur Pustaka. Kemudian, tambahkan jalur ke file header pustaka ke Sertakan Direktori.
- Di halaman properti Input Linker>, tambahkan nama file LIB ke Dependensi Tambahan.
Pustaka tautan dinamis
Jika DLL dibangun sebagai bagian dari solusi yang sama dengan aplikasi, ikuti langkah yang sama seperti untuk pustaka statis.
Jika DLL bukan bagian dari solusi aplikasi, Anda memerlukan: file DLL, header dengan prototipe untuk fungsi dan kelas yang diekspor, dan file LIB yang menyediakan informasi penautan yang diperlukan.
- Salin DLL ke folder output proyek Anda, atau ke folder lain di jalur pencarian Windows standar untuk DLL. Untuk informasi selengkapnya, lihat Urutan Pencarian Pustaka Dynamic-Link.
- Ikuti langkah 1-3 untuk pustaka statis untuk menyediakan jalur ke header dan file LIB.
Objek COM
Jika aplikasi C++ asli Anda perlu menggunakan objek COM, dan objek tersebut terdaftar, maka yang harus Anda lakukan adalah memanggil CoCreateInstance dan meneruskan CLSID objek. Sistem akan menemukannya di Registri Windows dan memuatnya. Proyek C++/CLI dapat menggunakan objek COM dengan cara yang sama. Atau, ia dapat menggunakannya dengan menambahkan referensi ke dalamnya dari daftar Tambahkan Referensi COM dan mengonsumsinya melalui pembungkus >yang dapat dipanggil Runtime- nya.
Rakitan .NET dan Komponen Runtime Windows
Dalam proyek UWP atau C++/CLI, Anda menggunakan rakitan .NET atau Komponen Runtime Windows dengan menambahkan referensi ke rakitan atau komponen. Di bawah simpul Referensi dalam proyek UWP atau C++/CLI, Anda melihat referensi ke komponen yang umum digunakan. Klik kanan pada node Referensi di Penjelajah Solusi untuk memunculkan Reference Manager dan telusuri komponen yang tersedia pada sistem. Pilih tombol Telusuri untuk menavigasi ke folder apa pun yang berisi komponen kustom. Karena komponen rakitan .NET dan Windows Runtime berisi informasi jenis bawaan, Anda dapat melihat metode dan kelasnya dengan mengklik kanan dan memilih Tampilkan di Browser Objek.
Properti referensi
Setiap jenis referensi memiliki properti. Anda dapat melihat properti dengan memilih referensi di Penjelajah Solusi dan menekan Alt + Enter, atau mengklik kanan dan memilih Properti. Beberapa properti bersifat baca-saja dan beberapa dapat dimodifikasi. Namun, biasanya Anda tidak perlu memodifikasi properti ini secara manual.
Properti referensi ActiveX
Properti referensi ActiveX hanya tersedia untuk referensi ke komponen COM. Properti ini hanya ditampilkan saat Anda memilih komponen COM di panel Referensi . Properti tidak dapat dimodifikasi.
Kontrol Jalur Penuh
Menampilkan jalur direktori kontrol yang direferensikan.
Kontrol GUID
Menampilkan GUID untuk kontrol ActiveX.
Versi Kontrol
Menampilkan versi kontrol ActiveX yang dirujuk.
Ketik Nama Pustaka
Menampilkan nama pustaka tipe yang dirujuk.
Alat Pembungkus
Menampilkan alat yang digunakan untuk membangun perakitan interop dari pustaka COM atau kontrol ActiveX yang dirujuk.
Properti referensi rakitan (C++/CLI)
Properti referensi rakitan hanya tersedia untuk referensi ke rakitan .NET Framework dalam proyek C++/CLI. Properti ini ditampilkan hanya saat Anda memilih rakitan .NET Framework di panel Referensi . Properti tidak dapat dimodifikasi.
Jalur Relatif
Menampilkan jalur relatif dari direktori proyek ke rakitan yang direferensikan.
Properti build
Properti berikut ini tersedia di berbagai jenis referensi. Mereka memungkinkan Anda menentukan cara membangun dengan referensi.
Salin Lokal
Menentukan apakah akan menyalin rakitan yang dirujuk secara otomatis ke lokasi target selama build.
Salin Rakitan Satelit Lokal (C++/CLI)
Menentukan apakah akan menyalin rakitan satelit secara otomatis dari rakitan yang dirujuk ke lokasi target selama build. Hanya digunakan jika Salin Lokal adalah
true
.Output Rakitan Referensi
Menentukan bahwa rakitan ini digunakan dalam proses build. Jika
true
, rakitan akan digunakan pada baris perintah pengkompilasi selama build.
Properti referensi proyek-ke-proyek
Properti berikut menentukan referensi proyek-ke-proyek dari proyek yang dipilih di panel Referensi ke proyek lain dalam solusi yang sama. Untuk informasi selengkapnya, lihat Mengelola referensi dalam proyek.
Menautkan Dependensi Pustaka
Ketika properti ini True, sistem proyek menautkan file LIB yang dihasilkan proyek independen ke dalam proyek dependen. Biasanya, Anda akan menentukan True.
Pengidentifikasi Proyek
Mengidentifikasi proyek independen secara unik. Nilai properti adalah GUID sistem internal yang tidak dapat dimodifikasi.
Menggunakan Input Dependensi Pustaka
Ketika properti ini False, sistem proyek tidak akan menautkan file OBJ untuk pustaka yang dihasilkan proyek independen ke dalam proyek dependen. Itulah sebabnya nilai ini menonaktifkan penautan inkremental. Biasanya, Anda akan menentukan False karena membangun aplikasi dapat memakan waktu lama jika ada banyak proyek independen.
Properti referensi baca-saja (COM & .NET)
Properti berikut ada pada referensi rakitan COM dan .NET, dan tidak dapat dimodifikasi.
Nama Rakitan
Menampilkan nama rakitan untuk rakitan yang dirujuk.
Budaya
Menampilkan budaya referensi terpilih.
Keterangan
Menampilkan deskripsi referensi terpilih.
Jalur Lengkap
Menampilkan jalur direktori dari rakitan yang direferensikan.
Identitas
Untuk rakitan .NET Framework, menampilkan jalur lengkap. Untuk komponen COM, menampilkan GUID.
Label
Menampilkan label referensi.
Nama
Menampilkan nama referensi.
Token Kunci Publik
Menampilkan token kunci publik yang digunakan untuk mengidentifikasi rakitan yang dirujuk.
Nama Yang Kuat
true
jika rakitan yang dirujuk memiliki nama yang kuat. Rakitan bernama yang kuat memiliki versi yang unik.Versi
Menampilkan versi rakitan yang dirujuk.
Baca juga
Referensi halaman properti proyek C++
Mengatur properti kompilator dan build C++ di Visual Studio
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk