

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Esegui la migrazione al server SDK 5.x per Amazon GameLift Servers
<a name="reference-serversdk5-migration"></a>

Per aggiornare un progetto di gioco per utilizzare la versione 5.x del server SDK, apporta le seguenti modifiche:

**Nota**  
Se devi continuare a utilizzare la versione 4.x o precedente dell'SDK del server, consulta la documentazione e le informazioni sul [Server SDK per la Amazon GameLift Servers versione 4 e precedenti](reference-serversdk4.md) download. [In particolare, per la versione SDK 4.0.2, puoi scaricarla dalle versioni ufficiali. GitHub ](https://github.com/amazon-gamelift/amazon-gamelift-servers-csharp-server-sdk/releases)

1. Scarica l'SDK del server più recente per il Amazon GameLift Servers pacchetto per il tuo ambiente di sviluppo **[[Scarica](https://aws.amazon.com/gamelift/servers/getting-started-sdks/)** il sito]. Segui le istruzioni di installazione contenute nel `Readme` file per il pacchetto e la versione scaricati. Consulta queste istruzioni per utilizzare il server SDKs con il tuo progetto di gioco.
   + [Per ambienti di sviluppo che utilizzano C\$1\$1, C\$1 o Go](gamelift-sdk-server-api.md)
   + [Per progetti Unreal Engine (SDK del server C\$1\$1 solo per le librerie Unreal)](integration-engines-setup-unreal.md)
   + [Per i progetti Unity (SDK del server C\$1 solo per le librerie Unity)](integration-engines-unity-using.md)
   + [Da utilizzare con il Amazon GameLift Servers plugin per Unreal Engine](unreal-plugin.md)
   + [Da usare con il Amazon GameLift Servers plugin per Unity](unity-plug-in.md)

1. Aggiorna il codice del server come segue:
   + Cambia la funzione di callback del codice server `onCreateGameSession()` in`onStartGameSession()`.
   + Aggiorna gli `InitSDK()` input in modo appropriato: 
     + Se hai intenzione di distribuire il server di gioco, crea una flotta EC2 Amazon GameLift Servers gestita o una flotta Anywhere con l'agente: Amazon GameLift Servers 

       [Chiama `InitSDK()` senza parametri ([C\$1\$1) (C\$1](integration-server-sdk5-cpp-actions.md#integration-server-sdk5-cpp-initsdk)[) (Unreal).](integration-server-sdk5-csharp-actions.md#integration-server-sdk5-csharp-initsdk)](integration-server-sdk5-unreal-actions.md#integration-server-sdk5-unreal-initsdk) Questa chiamata configura l'ambiente di calcolo e una WebSocket connessione al servizio. Amazon GameLift Servers 
     + Se hai intenzione di utilizzare il server di gioco, crea una flotta Anywhere senza l'Amazon GameLift Serversagente:

       [Chiama `InitSDK()` con i parametri del server ([C\$1\$1](integration-server-sdk5-cpp-actions.md#integration-server-sdk5-cpp-initsdk-anywhere)) ([C\$1) (Unreal).](integration-server-sdk5-csharp-actions.md#integration-server-sdk5-csharp-initsdk-anywhere)](integration-server-sdk5-unreal-actions.md#integration-server-sdk5-unreal-initsdk-anywhere) Un processo del server di gioco utilizza questi parametri per stabilire una connessione con il servizio. Amazon GameLift Servers

1. Se la build del server di gioco o altre applicazioni ospitate comunicano con altre AWS risorse durante l'esecuzione, dovrai modificare il modo in cui l'applicazione accede a tali risorse. Sostituisci l'uso di `AssumeRoleCredentials` con il nuovo server SDK action `GetFleetRoleCredentials()` (per i server di gioco) o usa credenziali condivise (per altre applicazioni). Per ulteriori informazioni su come implementare questa modifica, consulta. [Connect il server di gioco Amazon GameLift Servers ospitato ad altre AWS risorse](gamelift-sdk-server-resources.md)

1. [Se il progetto ha chiamato l'azione SDK del server `GetInstanceCertificate()` per recuperare un certificato TLS, modifica il codice per utilizzare invece il nuovo `GetComputeCertificate()` ([C\$1\$1) (C\$1](integration-server-sdk5-cpp-actions.md#integration-server-sdk5-cpp-getcomputecertificate)[) (Unreal).](integration-server-sdk5-csharp-actions.md#integration-server-sdk5-csharp-getcomputecertificate)](integration-server-sdk5-unreal-actions.md#integration-server-sdk5-unreal-getcomputecertificate)

1. Quando carichi la build del gioco su Amazon GameLift Servers (ad esempio con [upload-build](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/upload-build.html) o [CreateBuild())](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_CreateBuild.html), imposta il `ServerSdkVersion` parametro sulla versione 5.x che stai utilizzando (questo parametro attualmente è predefinito su 4.0.2). Questo parametro deve corrispondere alle librerie SDK del server effettive nella build del server di gioco. Se specifichi la versione sbagliata per una build del server di gioco caricata, tutte le flotte create con quella build falliranno. Per informazioni, consulta [Crea un server di gioco costruito per Amazon GameLift Servers](gamelift-build-cli-uploading.md).

   L'esempio seguente illustra come specificare la versione SDK del server: 

   ```
   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. Se utilizzi script per connetterti in remoto a flotte gestite, aggiorna gli script per utilizzare il nuovo processo, come descritto in. [Connect a flotte di istanze](fleets-remote-access.md)