Mettre à jour vos paramètres de compilation

Une fois la bibliothèque téléchargée sur votre ordinateur et enregistrée dans votre système de contrôle de code source, apportez les modifications suivantes aux paramètres de compilation de votre projet.

Bibliothèque statique

Procédez comme suit pour associer votre projet à la bibliothèque statique :

  1. Ajoutez gamesdk/include aux chemins d'accès include de votre compilateur.
  2. Incluez swappy/swappyVk.h pour l'intégration à Vulkan. Dans la plupart des cas, le fichier d'en-tête contient toutes les fonctions dont vous avez besoin pour intégrer la bibliothèque dans votre moteur.
  3. Ajoutez un chemin au format suivant dans les chemins d'accès à la bibliothèque de votre éditeur de liens :

    gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release
    

    Par exemple : gamesdk/libs/arm64-v8a_API24_NDK17_cpp_static_Release

  4. Ajoutez -lswappy_static à votre commande d'éditeur de liens.

Bibliothèque partagée

Les étapes ci-dessus renvoient un lien statique vers une version de la bibliothèque Frame Pacing compilée pour la combinaison d'ABI, de niveau d'API, de NDK et de STL. Si la combinaison n'est pas disponible pour vos paramètres, vous pouvez à la place créer un lien vers la bibliothèque partagée :

  1. Suivez les étapes 1 et 2 de la section précédente pour mettre à jour les chemins d'accès include de votre compilateur, et utilisez le fichier d'en-tête approprié.
  2. Ajoutez un chemin au format suivant dans les chemins d'accès à la bibliothèque de votre éditeur de liens :

    gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release/lib/swappy
    
  3. Ajoutez -lswappy à votre commande d'éditeur de liens.

Les liens statiques réduisent l'empreinte de votre code, car vous n'avez pas besoin de créer de bundle pour la bibliothèque partagée libswappy.so.

Utiliser CMake (bibliothèque statique uniquement)

Si vous utilisez CMake, consultez le fichier gamesdk/samples/bouncyball/app/CMakeLists.txt de la bibliothèque téléchargée pour obtenir un exemple de configuration CMake. Celui-ci inclut un fichier utilitaire, gamesdk/samples/gamesdk.cmake, qui effectue les vérifications finales, ajoute les bons chemins d'accès include du compilateur et génère une cible que vous pouvez utiliser pour associer la bibliothèque.

Pour utiliser cet utilitaire, procédez comme suit :

  1. Incluez ce fichier dans votre fichier CMakeLists.txt : include("path/to/gamesdk/samples/gamesdk.cmake")
  2. Appelez la fonction add_gamesdk_target avec le dossier contenant le gamesdk : add_gamesdk_target(PACKAGE_DIR path/to/gamesdk)
  3. Dans les target_link_libraries de votre bibliothèque native, ajoutez swappy comme dépendance : target_link_libraries(native-lib swappy ...)

Pour une utilisation avancée de CMake, consultez le fichier source gamesdk.cmake.