SanzSkuy: Created page with "`find_package` adalah command CMake untuk mendeteksi library eksternal yang sudah terinstall di sistem. CMake akan mencari konfigurasi library tersebut, lalu mengekspos '''imported target''' yang bisa langsung dipakai di `target_link_libraries`. find_package( [version] [REQUIRED] [COMPONENTS ...]) ; `REQUIRED` : Build langsung gagal jika library tidak ditemukan. ; `COMP..."`


2026-06-19T03:32:02Z
Created page with "<code>find_package</code> adalah command CMake untuk mendeteksi library eksternal yang sudah terinstall di sistem. CMake akan mencari konfigurasi library tersebut, lalu mengekspos '''imported target''' yang bisa langsung dipakai di <code>target_link_libraries</code>.  <syntaxhighlight lang="cmake"> find_package(<NamaPackage> [version] [REQUIRED] [COMPONENTS ...]) </syntaxhighlight>  ; <code>REQUIRED</code> : Build langsung gagal jika library tidak ditemukan. ; <code>COMP..."
New page
<code>find_package</code> adalah command CMake untuk mendeteksi library eksternal yang sudah terinstall di sistem. CMake akan mencari konfigurasi library tersebut, lalu mengekspos '''imported target''' yang bisa langsung dipakai di <code>target_link_libraries</code>.



<syntaxhighlight lang="cmake">

find_package(<NamaPackage> [version] [REQUIRED] [COMPONENTS ...])

</syntaxhighlight>



; <code>REQUIRED</code> : Build langsung gagal jika library tidak ditemukan.

; <code>COMPONENTS</code> : Beberapa package punya sub-komponen (misal Boost punya <code>filesystem</code>, <code>thread</code>, dll).



== Dua Mode Pencarian ==



=== 1. Module Mode (Find<Package>.cmake) ===



CMake mencari file bernama <code>Find<NamaPackage>.cmake</code> di direktori built-in-nya:



 /usr/share/cmake/Modules/FindMPI.cmake

 /usr/share/cmake/Modules/FindOpenCL.cmake

 /usr/share/cmake/Modules/FindBoost.cmake

 ... dst



File ini ditulis oleh tim CMake dan sudah bundled bersama instalasi CMake. File inilah yang berisi logika untuk mendeteksi library (scan path, cek header, cek linker flags, dll), sekaligus mendefinisikan imported target yang tersedia setelah <code>find_package</code> berhasil.



Untuk melihat daftar semua Find modules bawaan:

<syntaxhighlight lang="bash">

ls /usr/share/cmake/Modules/Find*.cmake

</syntaxhighlight>



=== 2. Config Mode (<Package>Config.cmake) ===



Jika tidak ada Find module bawaan, CMake mencari file <code><NamaPackage>Config.cmake</code> yang di-install oleh library itu sendiri ke sistem (biasanya di <code>/usr/lib/cmake/</code> atau <code>/usr/local/lib/cmake/</code>).



 /usr/lib/cmake/OpenCV/OpenCVConfig.cmake

 /usr/lib/cmake/fmt/fmtConfig.cmake



Library modern biasanya menyediakan file ini agar bisa ditemukan oleh CMake.



== Cara Tau Nama Package yang Valid ==



Nama yang ditulis di <code>find_package(XYZ)</code> harus '''persis cocok''' (case-sensitive) dengan nama file <code>FindXYZ.cmake</code> atau <code>XYZConfig.cmake</code>.



<syntaxhighlight lang="bash">

# Lihat semua Find modules yang tersedia di sistem

ls /usr/share/cmake/Modules/Find*.cmake



# Atau cari nama spesifik

ls /usr/share/cmake/Modules/ | grep -i mpi

</syntaxhighlight>



== Cara Tau Nama Imported Target ==



Setelah <code>find_package</code> sukses, dia membuat satu atau lebih '''imported target'''. Nama target ini didefinisikan di dalam file <code>Find<Package>.cmake</code>.



Cara menemukannya:



=== A. Baca langsung file .cmake-nya ===



<syntaxhighlight lang="bash">

# Cari baris yang mendefinisikan imported target

grep -i "add_library.*IMPORTED\|INTERFACE_INCLUDE\|MPI::" \

    /usr/share/cmake/Modules/FindMPI.cmake

</syntaxhighlight>



=== B. Baca dokumentasi CMake ===



Setiap Find module bawaan punya halaman dokumentasi resmi di https://cmake.org/cmake/help/latest/module/FindMPI.html (ganti <code>FindMPI</code> dengan nama module yang dicari).



=== C. Gunakan <code>cmake --help-module</code> ===



<syntaxhighlight lang="bash">

cmake --help-module FindMPI

cmake --help-module FindOpenCL

</syntaxhighlight>



== Contoh: MPI dan OpenCL ==



=== MPI ===



<syntaxhighlight lang="cmake">

find_package(MPI REQUIRED)

</syntaxhighlight>



Imported target yang tersedia setelah ini:



{| class="wikitable"

! Target !! Kegunaan

|-

| <code>MPI::MPI_C</code> || Untuk kode C

|-

| <code>MPI::MPI_CXX</code> || Untuk kode C++

|-

| <code>MPI::MPI_Fortran</code> || Untuk kode Fortran

|}



Cara CMake mendeteksi MPI: mencari program <code>mpicc</code> / <code>mpicxx</code> di PATH, lalu mengekstrak flags compile dan link dari sana.



=== OpenCL ===



<syntaxhighlight lang="cmake">

find_package(OpenCL REQUIRED)

</syntaxhighlight>



Imported target yang tersedia:



{| class="wikitable"

! Target !! Kegunaan

|-

| <code>OpenCL::OpenCL</code> || Satu-satunya target, untuk semua bahasa

|}



Cara CMake mendeteksi OpenCL: mencari header <code>CL/cl.h</code> atau <code>OpenCL/cl.h</code>, dan library <code>libOpenCL.so</code> di path sistem.



== Alur Kerja Lengkap ==



<pre>

find_package(MPI REQUIRED)

      │

      ▼

CMake baca FindMPI.cmake

      │

      ▼

FindMPI.cmake scan sistem

  - cek PATH untuk mpicc/mpicxx

  - ekstrak -I (include) dan -l (link) flags

      │

      ├─ Tidak ketemu ──► Error (karena REQUIRED)

      │

      └─ Ketemu ──► Buat imported target MPI::MPI_CXX

                          │

                          ▼

            target_link_libraries(matmul PRIVATE MPI::MPI_CXX)

                          │

                          ▼

            CMake otomatis tambahkan include path

            dan linker flags dari MPI ke binary matmul

</pre>



== Variabel yang Di-set oleh find_package ==



Selain imported target (cara modern), <code>find_package</code> juga men-set variabel lama (cara lama, masih valid):



{| class="wikitable"

! Variabel !! Isi

|-

| <code>MPI_FOUND</code> || <code>TRUE</code> jika ditemukan

|-

| <code>MPI_CXX_INCLUDE_DIRS</code> || Path ke header MPI

|-

| <code>MPI_CXX_LIBRARIES</code> || Path ke file library MPI

|-

| <code>MPI_CXX_COMPILE_FLAGS</code> || Flag compiler untuk MPI

|}



Cara modern (imported target) lebih direkomendasikan karena tidak perlu urus variabel-variabel ini secara manual.



== Tips Debugging ==



Jika <code>find_package</code> gagal:



<syntaxhighlight lang="bash">

# Jalankan cmake dengan output verbose untuk melihat apa yang dicari

cmake -DCMAKE_FIND_DEBUG_MODE=ON ..



# Cek apakah library terinstall

dpkg -l | grep -i libmpi        # Debian/Ubuntu

pacman -Q | grep -i mpi         # Arch Linux



# Cek apakah mpicc tersedia di PATH

which mpicc

mpicc --showme                  # Lihat flags yang dipakai

</syntaxhighlight>



== Referensi ==



* [https://cmake.org/cmake/help/latest/command/find_package.html Dokumentasi find_package]

* [https://cmake.org/cmake/help/latest/module/FindMPI.html FindMPI module]

* [https://cmake.org/cmake/help/latest/module/FindOpenCL.html FindOpenCL module]
CMake find package - Revision history
