یکپارچه سازی سیستم های ساخت سفارشی C/C++ با استفاده از Ninja (تجربی)

برای فعال کردن پشتیبانی Ninja در AGP، experimentalProperties را در فایل build.gradle سطح ماژول پیکربندی کنید:

android {
  defaultConfig {
    externalNativeBuild {
      experimentalProperties["ninja.abiFilters"] = [ "x86", "arm64-v8a" ]
      experimentalProperties["ninja.path"] = "source-file-list.txt"
      experimentalProperties["ninja.configure"] = "configure-ninja"
      experimentalProperties["ninja.arguments"] = [
            "\${ndk.moduleMakeFile}",
            "--variant=\${ndk.variantName}",
            "--abi=Android-\${ndk.abi}",
            "--configuration-dir=\${ndk.configurationDir}",
            "--ndk-version=\${ndk.moduleNdkVersion}",
            "--min-sdk-version=\${ndk.minSdkVersion}"
       ]
     }
   }

ویژگی ها توسط AGP به صورت زیر تفسیر می شوند:

• ninja.abiFilters فهرستی از ABI برای ساخت است. مقادیر معتبر عبارتند از: x86 ، x86-64 ، armeabi-v7a ، و arm64-v8a .

• ninja.path مسیری به فایل پروژه C/C++ است. فرمت این فایل می تواند هر چیزی که می خواهید باشد. تغییراتی که در این فایل ایجاد می‌شود، یک درخواست برای همگام‌سازی Gradle در Android Studio ایجاد می‌کند.

• ninja.configure مسیری به فایل اسکریپت است که زمانی که نیاز به پیکربندی پروژه C/C++ باشد توسط Gradle اجرا می شود. یک پروژه در اولین ساخت، در حین همگام سازی Gradle در Android Studio، یا زمانی که یکی از ورودی های پیکربندی اسکریپت تغییر می کند، پیکربندی می شود.

• ninja.arguments لیستی از آرگومان هایی است که به اسکریپت تعریف شده توسط ninja.configure ارسال می شود. عناصر موجود در این لیست می توانند به مجموعه ای از ماکروها اشاره کنند که مقادیر آنها به زمینه پیکربندی فعلی در AGP بستگی دارد:

  • ${ndk.moduleMakeFile} مسیر کامل فایل ninja.configure است. بنابراین در مثال، C:\path\to\configure-ninja.bat خواهد بود.

  • ${ndk.variantName} نام نوع فعلی AGP است که در حال ساخت است. به عنوان مثال، اشکال زدایی یا انتشار.

  • ${ndk.abi} نام AGP ABI فعلی است که در حال ساخت است. به عنوان مثال، x86 یا arm64-v8a .

  • ${ndk.buildRoot} نام پوشه ای است که توسط AGP تولید شده است و اسکریپت خروجی خود را در آن می نویسد. جزئیات این مورد در مرحله 2 توضیح داده خواهد شد: اسکریپت پیکربندی را ایجاد کنید .

  • ${ndk.ndkVersion} نسخه NDK مورد استفاده است. این مقدار معمولاً مقداری است که در فایل build.gradle به android.ndkVersion ارسال می‌شود یا اگر هیچ کدام وجود نداشته باشد، یک مقدار پیش‌فرض است.

  • ${ndk.minPlatform} حداقل پلتفرم Android هدف درخواست شده توسط AGP است.

• ninja.targets لیستی از اهداف خاص نینجا است که باید ساخته شوند.

rule COMPILE
   command = /path/to/ndk/clang -c $in -o $out {other flags}
rule LINK
   command = /path/to/ndk/clang $in -o $out {other flags}

build source.o : COMPILE source.cpp
build lib.so : LINK source.o

build curl: phony /path/to/lib.so

android {
  defaultConfig {
    externalNativeBuild {
      ...
      experimentalProperties["ninja.targets"] = [ "curl" ]

rule COMPILE
   command = /path/to/ndk/clang $in -o $out {other flags}
rule LINK
   command = /path/to/ndk/clang $in -o $out {other flags}

build foo.o : COMPILE foo.cpp
build bar.o : COMPILE bar.cpp
build libfoo.so : LINK foo.o
build libbar.so : LINK bar.o
build all: phony libfoo.so libbar.so

rule COMPILE
   command = /path/to/ndk/clang $in -o $out {other flags}
rule LINK
   command = /path/to/ndk/clang $in -o $out {other flags}

rule MBSUILD_CURL
  command = /path/to/msbuild {flags to build curl with MSBuild}

build source.o : COMPILE source.cpp
build lib.so : LINK source.o
build curl : phony lib.so
build curl.passthrough : MBSUILD_CURL