تعديل إعدادات الإصدار

توضح الأقسام التالية كيفية دمج مكتبة "الشوكة الرنانة" في سلسلة الأدوات الخاصة بك وكيفية استخدام الدوال التي توفرها المكتبة. تتوفر المكتبة كمكتبة ثابتة أو مشتركة في مكتبات AGDK.

بعد تنزيل SDK على جهازك وفحصه في نظام التحكم في المصدر، أجرِ التغييرات المدرجة في الأقسام التالية على إعدادات إصدار مشروعك.

قبل البدء

يجب دمج مكتبة Android Frame Pacing قبل دمج مكتبة Tuning Fork. إذا قمت بذلك، فيمكن لمكتبة Tuning Fork تسجيل وقت عرض الإطار تلقائيًا؛ ليست هناك حاجة لاستدعاء دوال التجزئة بنفسك بشكل صريح.

يُرجى الاطّلاع على أدلة الدمج التالية للحصول على مزيد من المعلومات:

مكتبة ثابتة

لربط مشروعك بالمكتبة الثابتة، قم بما يلي:

  1. أضِف gamesdk/include إلى برنامج تجميع المسارات.

  2. أضف مسارًا للنموذج التالي في مسارات مكتبة الروابط:

    gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release

    ابحث في gamesdk/libs واختَر الأداة التي تناسب سلسلة أدواتك (على سبيل المثال، gamesdk/libs/arm64-v8a_API24_NDK17_cpp_static_Release).

  3. أضِف -ltuningfork_static إلى أمر الرابط (و-lswappy_static في حال دمج مكتبة Android Frame Pacing).

  4. إضافة إذن "INTERNET" إلى ملف AndroidManifest.xml:

    <uses-permission android:name="android.permission.INTERNET" />

المكتبة المشتركة

إنّ الخطوات الواردة في قسم المكتبة الثابتة ترتبط بشكل ثابت بنُسخة من مكتبة "الشوكة الرنانة" التي يتم تجميعها لمجموعة ABI ومستوى واجهة برمجة التطبيقات وNDK وSTL. إذا لم تكن هذه التركيبة متاحة لإعداداتك، يمكنك بدلاً من ذلك الربط بالمكتبة المشتركة:

  1. أضِف gamesdk/include إلى برنامج تجميع المسارات.

  2. أضف مسارًا للنموذج التالي في مسارات مكتبة الروابط:

    gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release/lib/tuningfork

  3. أضِف -ltuningfork إلى أمر الرابط (و-lswappy في حال دمج مكتبة Android Frame Pacing).

  4. إضافة إذن "INTERNET" إلى ملف AndroidManifest.xml:

    <uses-permission android:name="android.permission.INTERNET" />

يمنحك الربط الثابت بصمة رمز أصغر بكثير، فلست بحاجة إلى تجميع مكتبة libtuningfork.so المشتركة.

استخدام CMake (المكتبة الثابتة فقط)

إذا كنت تستخدم CMake، فراجع ملف gamesdk/samples/tuningfork/insightsdemo/app/CMakeLists.txt للحصول على مثال إعدادات CMake. ويتضمّن ملف الأدوات gamesdk/samples/gamesdk.cmake الذي ينفِّذ عمليات تحقُّق نهائية، ويضيف مسارات تضمين برامج التحويل المناسبة، ثم ينشئ هدفًا يمكنك استخدامه لربط المكتبة.

لاستخدام هذه الأداة، قم بما يلي:

  1. أدرِج هذا الملف في ملف CMakeLists.txt: include("path/to/gamesdk/samples/gamesdk.cmake")
  2. استدعِ الدالة add_gamesdk_target مع المجلد الذي يحتوي على gamesdk: add_gamesdk_target(PACKAGE_DIR path/to/gamesdk)
  3. في target_link_libraries لمكتبتك الأصلية، أضِف tuningfork كعنصر تبعية (وswappy في حال دمج مكتبة Android Frame Pacing): target_link_libraries(native-lib swappy tuningfork ...)

للاستخدام المتقدِّم لتطبيق CMake الخاص، اطّلِع على gamesdk.cmake الملف المصدر.

السابق
تفعيل واجهة برمجة التطبيقات لمَعلمات الأداء في Android
التالي
تحديد التعليقات التوضيحية ومعلّمات الدقة والإعدادات