बिल्ड की सेटिंग अपडेट करें

यहां दिए गए सेक्शन में, Tuning Fork लाइब्रेरी को टूलचेन में इंटिग्रेट करने का तरीका बताया गया है. साथ ही, लाइब्रेरी में मौजूद फ़ंक्शन इस्तेमाल करने का तरीका भी बताया गया है. यह लाइब्रेरी, AGDK Libraries में स्टैटिक या शेयर की गई लाइब्रेरी के तौर पर उपलब्ध है.

अपने कंप्यूटर पर एसडीके डाउनलोड करने और इसे सोर्स कंट्रोल सिस्टम में चेक करने के बाद, अपने प्रोजेक्ट की बिल्ड सेटिंग में यहां दिए गए बदलाव करें.

शुरू करने से पहले

आपको Tuning Fork लाइब्रेरी को इंटिग्रेट करने से पहले, Android Frame Pacing लाइब्रेरी को इंटिग्रेट करना होगा. ऐसा करने पर, Tuning Fork लाइब्रेरी फ़्रेम टाइम को अपने-आप रिकॉर्ड कर सकती है. आपको खुद से टिक फ़ंक्शन को कॉल करने की ज़रूरत नहीं है.

ज़्यादा जानकारी के लिए, इंटिग्रेशन से जुड़ी ये गाइड देखें:

• Android फ़्रेम पेसिंग को अपने OpenGL रेंडरर के साथ इंटिग्रेट करना
• Android फ़्रेम पेसिंग को अपने 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 जोड़ें. साथ ही, अगर आपने Android Frame Pacing लाइब्रेरी को इंटिग्रेट किया है, तो -lswappy_static जोड़ें.

4. अपनी AndroidManifest.xml फ़ाइल में INTERNET की अनुमति जोड़ें:

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

शेयर लाइब्रेरी

स्टैटिक लाइब्रेरी सेक्शन में दिए गए चरणों में, दिए गए ABI, एपीआई लेवल, NDK, और STL कॉम्बिनेशन के लिए कंपाइल की गई Tuning Fork लाइब्रेरी के वर्शन के साथ स्टैटिक रूप से लिंक किया जाता है. अगर आपकी सेटिंग के लिए यह कॉम्बिनेशन उपलब्ध नहीं है, तो शेयर की गई लाइब्रेरी से लिंक करें:

1. अपने कंपाइलर के शामिल किए गए पाथ में gamesdk/include जोड़ें.

2. लिंकर लाइब्रेरी के पाथ में, इस फ़ॉर्म का पाथ जोड़ें:

   gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release/lib/tuningfork
   

3. लिंकर कमांड में -ltuningfork जोड़ें. साथ ही, अगर आपने Android Frame Pacing लाइब्रेरी को इंटिग्रेट किया है, तो -lswappy जोड़ें.

4. अपनी AndroidManifest.xml फ़ाइल में INTERNET की अनुमति जोड़ें:

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

स्टैटिक लिंकिंग से, कोड का साइज़ काफ़ी कम हो जाता है. ऐसा इसलिए होता है, क्योंकि आपको libtuningfork.so शेयर की गई लाइब्रेरी को बंडल करने की ज़रूरत नहीं होती.

CMake का इस्तेमाल करना (सिर्फ़ स्टैटिक लाइब्रेरी के लिए)

अगर CMake का इस्तेमाल किया जा रहा है, तो CMake कॉन्फ़िगरेशन के उदाहरण के लिए, gamesdk/samples/tuningfork/insightsdemo/app/CMakeLists.txt फ़ाइल देखें. इसमें एक यूटिलिटी फ़ाइल, gamesdk/samples/gamesdk.cmake शामिल होती है. यह फ़ाइल, फ़ाइनल जांच करती है, कंपाइलर के लिए सही पाथ जोड़ती है, और एक ऐसा टारगेट जनरेट करती है जिसका इस्तेमाल लाइब्रेरी को लिंक करने के लिए किया जा सकता है.

इस यूटिलिटी का इस्तेमाल करने के लिए, यह तरीका अपनाएं:

1. अपनी CMakeLists.txt फ़ाइल में यह फ़ाइल शामिल करें: include("path/to/gamesdk/samples/gamesdk.cmake")
2. gamesdk वाले फ़ोल्डर के साथ add_gamesdk_target फ़ंक्शन को कॉल करें: add_gamesdk_target(PACKAGE_DIR path/to/gamesdk)
3. अपनी नेटिव लाइब्रेरी के target_link_libraries में, tuningfork को डिपेंडेंसी के तौर पर जोड़ें. साथ ही, अगर आपने Android फ़्रेम पेसिंग लाइब्रेरी को इंटिग्रेट किया है, तो swappy को भी जोड़ें: target_link_libraries(native-lib swappy tuningfork ...)

CMake का ऐडवांस तरीके से इस्तेमाल करने के लिए, gamesdk.cmake सोर्स फ़ाइल देखें.