Bagikan melalui


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:

Mengkonsumsi pustaka statis

Jika proyek pustaka statis Anda dibangun dalam solusi yang sama:

  1. #include file header untuk pustaka statis menggunakan tanda kutip. Dalam solusi umum, jalur dimulai dengan ../<library project name>. IntelliSense akan membantu Anda menemukannya.
  2. 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:

  1. Klik kanan pada simpul proyek aplikasi di Penjelajah Solusi lalu pilih Properti.
  2. 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.
  3. Di halaman properti Input Linker>, tambahkan nama file LIB ke Dependensi Tambahan.

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.

  1. 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.
  2. 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