> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Démarrage rapide C++ pour Linux

> Configurez un projet C++ natif sur Ubuntu 18.04 LTS et effectuez votre premier appel d'API PlayFab à l'aide de la bibliothèque multiplateforme XPlatCppSdk de PlayFab.

# Démarrage rapide : C++ pour Linux

Prenez en main la bibliothèque cliente PlayFab pour C++. Suivez les étapes pour installer le package et essayer l'exemple de code pour une tâche de base.

Ce démarrage rapide vous aide à effectuer votre premier appel d'API PlayFab à l'aide de la bibliothèque cliente pour C++.

Ce démarrage rapide a été rédigé avec Ubuntu 18.04 LTS.

[Documentation de référence de l'API](/fr-CA/services/playfab/api-references) | [Code source de la bibliothèque](https://github.com/PlayFab/XPlatCppSdk)

## Configuration requise

* Un [compte de développeur PlayFab](https://developer.playfab.com).

## Configuration du projet C++ Linux

1. Installez les éléments suivants (sudo apt-get install \_\_\_\_ sur Ubuntu) :
   * g++
   * gdb
   * make
   * cmake
   * libjsoncpp-dev
   * libcurl4-openssl-dev
   * git-all
2. Clonez le [SDK multiplateforme (CPP) PlayFab](https://github.com/PlayFab/XPlatCppSdk) dans le dossier de votre projet.

Pour vérifier que votre installation est correcte :

Créez un fichier main.cpp et insérez le code « Hello World » ci-dessous.

```cpp theme={null}
// main.cpp: entry point for the console application

#include <iostream>

int main()
{
    std::cout << "Hello World" << std::endl;
    return 0;
}
```

Si vous utilisez un IDE, assurez-vous de :

* Ajouter les dossiers suivants à vos sources :
  * XPlatCppSdk/cppsdk/source/playfab

* Ajouter les dossiers suivants à vos répertoires d'inclusion :
  * XPlatCppSdk/cppsdk
  * XPlatCppSdk/cppsdk/include

* Lier les bibliothèques suivantes :
  * jsoncpp
  * curl
  * pthread

Sinon, créez un fichier nommé CMakeLists.txt et copiez-y les commandes de génération ci-dessous.

```cmake theme={null}
cmake_minimum_required(VERSION 3.10)
set(CMAKE_CXX_STANDARD 14)

project(PlayFab_Test)

file(GLOB PF_SOURCE XPlatCppSdk/cppsdk/source/playfab/*.cpp)
add_executable(PlayFab_Test ${PF_SOURCE} main.cpp)

include_directories(XPlatCppSdk/cppsdk)
include_directories(XPlatCppSdk/cppsdk/include)
target_link_libraries(PlayFab_Test -ljsoncpp -lcurl -lpthread)
```

* Générez et exécutez le projet depuis votre IDE, ou ouvrez un terminal et exécutez :
  * `cmake .`
  * `make`
  * `./PlayFab_Test`

## Configurer votre premier appel d'API

Ce guide présente les étapes minimales nécessaires pour effectuer votre premier appel d'API PlayFab, sans interface graphique ni retour à l'écran. La confirmation s'effectue à l'aide d'une instruction d'affichage dans la console.

Tout d'abord, remplacez le contenu de `main.cpp` par le contenu ci-dessous.

```cpp theme={null}
// main.cpp: entry point for the console application

#include "playfab/PlayFabClientDataModels.h"
#include "playfab/PlayFabClientApi.h"
#include "playfab/PlayFabSettings.h"
#include <unistd.h>

using namespace PlayFab;
using namespace ClientModels;

bool finished = false;

void OnLoginSuccess(const LoginResult& result, void* customData)
{
    printf("Congratulations, you made your first successful API call!\n");
    finished = true;
}

void OnLoginFail(const PlayFabError& error, void* customData)
{
    printf("Something went wrong with your first API call.\n");
    printf("Here's some debug information:\n");
    printf(error.GenerateReport().c_str());
    printf("\n");
    finished = true;
}

int main()
{
    PlayFabSettings::staticSettings->titleId = ("144");

    LoginWithCustomIDRequest request;
    request.CreateAccount = true;
    request.CustomId = "GettingStartedGuide";

    PlayFabClientAPI::LoginWithCustomID(request, OnLoginSuccess, OnLoginFail);

    while (PlayFabClientAPI::Update() != 0)
        sleep(1);

    printf("Press enter to exit\n");
    getchar();
    return 0;
}
```

## Terminer et exécuter

1. Générez et exécutez le projet dans votre IDE, ou ouvrez un terminal et exécutez :
   * `./PlayFab_Test`

2. Au chargement, le texte suivant s'affiche :
   * "Congratulations, you made your first successful API call!"

3. Commencez à effectuer d'autres appels d'API et à développer votre titre.


## Related topics

- [Démarrage rapide Linux](/fr-CA/services/playfab/sdks/c/quickstart-linux.md)
- [Démarrage rapide NodeJS](/fr-CA/services/playfab/sdks/nodejs/quickstart.md)
- [Démarrage rapide Unity](/fr-CA/services/playfab/sdks/unity3d/quickstart.md)
- [Démarrage rapide C++ pour Windows](/fr-CA/services/playfab/sdks/playfab-cpp/quickstart-windows.md)
- [Démarrage rapide Unreal Engine](/fr-CA/services/playfab/sdks/unreal/quickstart.md)