

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Migrieren Sie zum Server-SDK 5.x für Amazon GameLift Servers
<a name="reference-serversdk5-migration"></a>

Um ein Spieleprojekt so zu aktualisieren, dass es das Server-SDK Version 5.x verwendet, nehmen Sie die folgenden Änderungen vor:

**Anmerkung**  
Wenn du das Server-SDK Version 4.x oder früher weiterhin verwenden musst, findest du die Dokumentation und Download-Informationen [Server-SDK für Amazon GameLift Servers Version 4 und früher](reference-serversdk4.md) unter. Speziell für die SDK-Version 4.0.2 können Sie sie von den [offiziellen GitHub ](https://github.com/amazon-gamelift/amazon-gamelift-servers-csharp-server-sdk/releases) Versionen herunterladen.

1. Holen Sie sich das neueste Server-SDK für Amazon GameLift Servers das Paket für Ihre Entwicklungsumgebung **[[Download-Seite].](https://aws.amazon.com/gamelift/servers/getting-started-sdks/)** Folgen Sie den Installationsanweisungen in der `Readme` Datei für Ihr heruntergeladenes Paket und Ihre heruntergeladene Version. In dieser Anleitung erfährst du, wie du den Server SDKs mit deinem Spielprojekt verwendest.
   + [Für Entwicklungsumgebungen, die C\$1\$1, C\$1 oder Go verwenden](gamelift-sdk-server-api.md)
   + [Für Unreal Engine-Projekte (nur C\$1\$1-Server-SDK für Unreal-Bibliotheken)](integration-engines-setup-unreal.md)
   + [Für Unity-Projekte (C\$1-Server-SDK nur für Unity-Bibliotheken)](integration-engines-unity-using.md)
   + [Zur Verwendung mit dem Amazon GameLift Servers Plugin für Unreal Engine](unreal-plugin.md)
   + [Zur Verwendung mit dem Amazon GameLift Servers Plugin für Unity](unity-plug-in.md)

1. Aktualisieren Sie Ihren Servercode wie folgt:
   + Ändern Sie die Servercode-Callback-Funktion `onCreateGameSession()` auf`onStartGameSession()`.
   + Aktualisieren Sie die `InitSDK()` Eingaben nach Bedarf: 
     + Wenn Sie planen, den Spielserver-Build entweder auf einer Amazon GameLift Servers verwalteten EC2-Flotte oder einer Anywhere-Flotte mit dem Amazon GameLift Servers Agenten bereitzustellen: 

       Aufruf `InitSDK()` ohne Parameter ([C\$1\$1](integration-server-sdk5-cpp-actions.md#integration-server-sdk5-cpp-initsdk)) ([C\$1) ([Unreal](integration-server-sdk5-unreal-actions.md#integration-server-sdk5-unreal-initsdk)).](integration-server-sdk5-csharp-actions.md#integration-server-sdk5-csharp-initsdk) Dieser Aufruf richtet die Rechenumgebung und eine WebSocket Verbindung zum Amazon GameLift Servers Dienst ein. 
     + Wenn du vorhast, den Gameserver-Build auf einer Anywhere-Flotte ohne den Amazon GameLift Servers Agenten bereitzustellen:

       Aufruf `InitSDK()` mit Serverparametern ([C\$1\$1](integration-server-sdk5-cpp-actions.md#integration-server-sdk5-cpp-initsdk-anywhere)) ([C\$1](integration-server-sdk5-csharp-actions.md#integration-server-sdk5-csharp-initsdk-anywhere)) ([Unreal](integration-server-sdk5-unreal-actions.md#integration-server-sdk5-unreal-initsdk-anywhere)). Ein Spieleserver-Prozess verwendet diese Parameter, um eine Verbindung mit dem Amazon GameLift Servers Dienst herzustellen.

1. Wenn dein Gameserver-Build oder andere gehostete Anwendungen während der Ausführung mit anderen AWS Ressourcen kommunizieren, musst du ändern, wie die Anwendung auf diese Ressourcen zugreift. Ersetzen Sie die Verwendung von `AssumeRoleCredentials` durch die neue Server-SDK-Aktion `GetFleetRoleCredentials()` (für Spieleserver) oder verwenden Sie gemeinsam genutzte Anmeldeinformationen (für andere Anwendungen). Weitere Informationen zur Implementierung dieser Änderung finden Sie unter[Connect deinen Amazon GameLift Servers gehosteten Spieleserver mit anderen AWS Ressourcen](gamelift-sdk-server-resources.md).

1. Wenn Ihr Projekt die Server-SDK-Aktion `GetInstanceCertificate()` zum Abrufen eines TLS-Zertifikats aufgerufen hat, ändern Sie Ihren Code so, dass er stattdessen das neue `GetComputeCertificate()` ([C\$1\$1](integration-server-sdk5-cpp-actions.md#integration-server-sdk5-cpp-getcomputecertificate)) ([C\$1](integration-server-sdk5-csharp-actions.md#integration-server-sdk5-csharp-getcomputecertificate)) ([Unreal](integration-server-sdk5-unreal-actions.md#integration-server-sdk5-unreal-getcomputecertificate)) verwendet.

1. Wenn du deinen Spiel-Build hochlädst Amazon GameLift Servers (z. B. mit [upload-build](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/upload-build.html) oder [CreateBuild())](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_CreateBuild.html), setze den `ServerSdkVersion` Parameter auf die 5.x-Version, die du verwendest (dieser Parameter ist derzeit standardmäßig auf 4.0.2 voreingestellt). Dieser Parameter muss mit den tatsächlichen Server-SDK-Bibliotheken im Spielserver-Build übereinstimmen. Wenn Sie die falsche Version für einen hochgeladenen Spielserver-Build angeben, schlagen alle Flotten fehl, die Sie mit diesem Build erstellen. Siehe [Erstelle einen Gameserver-Build für Amazon GameLift Servers](gamelift-build-cli-uploading.md).

   Das folgende Beispiel zeigt, wie die Server-SDK-Version angegeben wird: 

   ```
   aws gamelift upload-build \
       --operating-system AMAZON_LINUX_2023 \
       --server-sdk-version "5.0.0" \
       --build-root "~/mygame" \
       --name "My Game Nightly Build" \
       --build-version "build 255" \
       --region us-west-2
   ```

1. Wenn Sie Skripts verwenden, um eine Remoteverbindung zu verwalteten Flotten herzustellen, aktualisieren Sie die Skripts so, dass sie den neuen Prozess verwenden, wie unter beschrieben[Connect zu Flotteninstanzen herstellen](fleets-remote-access.md).