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

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

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

قبل البدء

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

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

• دمج ميزة Android Frame Pacing في عارض OpenGL
• دمج إطار Android Frame Pacing في عارض Vulkan

مكتبة ثابتة

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

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" />
   

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

الخطوات في قسم المكتبة الثابتة تؤدي إلى إنشاء رابط ثابت مقابل نسخة من مكتبة Tuning Fork التي تم تجميعها لواجهة التطبيق الثنائية (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 مع المجلد الذي يحتوي على حزمة تطوير البرامج (SDK) للألعاب: add_gamesdk_target(PACKAGE_DIR path/to/gamesdk)
3. في target_link_libraries لمكتبتك المدمجة مع المحتوى، أضِف tuningfork باعتباره (وswappy في حال دمج نظام سرعة إطار Android) ): target_link_libraries(native-lib swappy tuningfork ...)

ملاحظة: يمكن أن يؤدي المسار إلى Gamesdk المستخدَم مع include وadd_gamesdk_target إما أن تكون مطلقة (على سبيل المثال، /home/yourusername/gamesdk أو C:\Android\gamesdk) أو مرتبط بملف CMakeLists.txt.

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