Perbedaan antara CMAKE_CURRENT_SOURCE_DIR dan CMAKE_CURRENT_LIST_DIR

Dari Wiki:

CMAKE_CURRENT_SOURCE_DIR ini adalah direktori tempat CMakeLists.txt yang sedang diproses berada di

CMAKE_CURRENT_LIST_DIR (sejak 2.8.3) ini adalah direktori dari listfile yang sedang diproses.

Dari Dokumen:

CMAKE_CURRENT_SOURCE_DIR: Jalur ke direktori sumber sedang diproses. Ini jalur lengkap ke direktori sumber yang saat ini sedang diproses oleh cmake.

CMAKE_CURRENT_LIST_DIR: Direktori lengkap listfile yang sedang diproses. Saat CMake memproses file daftar dalam proyek Anda, variabel ini akan selalu disetel ke direktori tempat listfile yang saat ini sedang diproses (CMAKE_CURRENT_LIST_FILE) berada. Nilainya memiliki ruang lingkup dinamis. Ketika CMake mulai memproses perintah dalam file sumber, CMake menetapkan variabel ini ke direktori tempat file ini berada. Ketika CMake selesai memproses perintah dari file itu mengembalikan nilai sebelumnya. Oleh karena itu, nilai variabel di dalam makro atau fungsi adalah direktori file yang memanggil entri paling bawah pada tumpukan panggilan, bukan direktori file yang berisi definisi makro atau fungsi.

Dalam keadaan apa variabel ini memiliki nilai yang berbeda?

Variabel CMAKE_CURRENT_SOURCE_DIRdan CMAKE_CURRENT_LIST_DIRmungkin merujuk ke direktori yang berbeda untuk file daftar CMake yang disertakan oleh file lain dengan perintah include . Misalnya, jika a CMakeLists.txtada dalam direktori projectdan berisi petunjuk berikut

include(src/CMakeLists.txt)

maka saat src/CMakeLists.txtsedang diproses CMAKE_CURRENT_LIST_DIRakan merujuk ke project/srcsedangkan CMAKE_CURRENT_SOURCE_DIRmasih menunjuk ke direktori terluar project.

CMAKE_CURRENT_LIST_DIRberguna saat Anda perlu mencari file sumber daya seperti file template atau skrip batch yang terletak di sebelah CMakeLists.txtfile yang sedang diproses.

_{Catatan: Saat menggunakan add_subdirectory()perintah daripada include(), perilakunya berbeda, dan saat src/CMakeLists.txtdiproses, kedua variabel akan mengarah ke project/src.}