Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Migrasi ke server SDK 5.x untuk Amazon GameLift Servers
<a name="reference-serversdk5-migration"></a>

Untuk memperbarui proyek game agar menggunakan server SDK versi 5.x, buat perubahan berikut:

**catatan**  
Jika Anda perlu terus menggunakan SDK server versi 4.x atau yang lebih lama, lihat informasi [Server SDK untuk Amazon GameLift Servers versi 4 dan sebelumnya](reference-serversdk4.md) dokumentasi dan unduhan. Untuk SDK versi 4.0.2 khusus, Anda dapat mengunduhnya dari rilis [resmi GitHub ](https://github.com/amazon-gamelift/amazon-gamelift-servers-csharp-server-sdk/releases).

1. Dapatkan SDK server terbaru untuk Amazon GameLift Servers paket untuk lingkungan pengembangan Anda **[[Unduh situs](https://aws.amazon.com/gamelift/servers/getting-started-sdks/)]**. Ikuti petunjuk penginstalan dalam `Readme` file untuk paket dan versi yang Anda unduh. Lihat petunjuk ini untuk menggunakan server SDKs dengan proyek game Anda.
   + [Untuk lingkungan pengembangan menggunakan C \$1\$1, C \$1, atau Go](gamelift-sdk-server-api.md)
   + [Untuk proyek Unreal Engine (SDK server C\$1\$1 hanya untuk pustaka Unreal)](integration-engines-setup-unreal.md)
   + [Untuk proyek Unity (SDK server C\$1 hanya untuk pustaka SDK for Unity)](integration-engines-unity-using.md)
   + [Untuk digunakan dengan Amazon GameLift Servers plugin untuk Unreal Engine](unreal-plugin.md)
   + [Untuk digunakan dengan Amazon GameLift Servers plugin untuk Unity](unity-plug-in.md)

1. Perbarui kode server Anda sebagai berikut:
   + Ubah fungsi callback kode server `onCreateGameSession()` menjadi`onStartGameSession()`.
   + Perbarui `InitSDK()` input yang sesuai: 
     + Jika Anda berencana untuk menerapkan build server game ke armada EC2 Amazon GameLift Servers terkelola atau armada Anywhere dengan Agen: Amazon GameLift Servers 

       Panggilan `InitSDK()` tanpa parameter ([C \$1\$1](integration-server-sdk5-cpp-actions.md#integration-server-sdk5-cpp-initsdk)) (C [\$1](integration-server-sdk5-csharp-actions.md#integration-server-sdk5-csharp-initsdk)) ([Tidak](integration-server-sdk5-unreal-actions.md#integration-server-sdk5-unreal-initsdk) nyata). Panggilan ini mengatur lingkungan komputasi dan WebSocket koneksi ke Amazon GameLift Servers layanan. 
     + Jika Anda berencana untuk menyebarkan build server game ke armada Anywhere tanpa Amazon GameLift Servers Agen:

       Panggilan `InitSDK()` dengan parameter server ([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)) ([Tidak](integration-server-sdk5-unreal-actions.md#integration-server-sdk5-unreal-initsdk-anywhere) nyata). Proses server game menggunakan parameter ini untuk membuat koneksi dengan Amazon GameLift Servers layanan.

1. Jika build server game atau aplikasi host lainnya berkomunikasi dengan AWS sumber daya lain saat berjalan, Anda harus mengubah cara aplikasi mendapatkan akses ke sumber daya tersebut. Ganti penggunaan `AssumeRoleCredentials` dengan aksi SDK server baru `GetFleetRoleCredentials()` (untuk server game) atau gunakan kredensyal bersama (untuk aplikasi lain). Untuk informasi lebih lanjut tentang cara menerapkan perubahan ini, lihat[Hubungkan server game yang Amazon GameLift Servers di-host ke AWS sumber daya lain](gamelift-sdk-server-resources.md).

1. [Jika proyek Anda memanggil tindakan SDK server `GetInstanceCertificate()` untuk mengambil sertifikat TLS, ubah kode Anda untuk menggunakan new `GetComputeCertificate()` ([C\$1\$1) ([C\$1](integration-server-sdk5-csharp-actions.md#integration-server-sdk5-csharp-getcomputecertificate)) (Unreal](integration-server-sdk5-cpp-actions.md#integration-server-sdk5-cpp-getcomputecertificate)) sebagai gantinya.](integration-server-sdk5-unreal-actions.md#integration-server-sdk5-unreal-getcomputecertificate)

1. Saat mengunggah build game Anda Amazon GameLift Servers (seperti dengan [upload-build](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/upload-build.html) atau [CreateBuild())](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_CreateBuild.html), setel `ServerSdkVersion` parameter ke versi 5.x yang Anda gunakan (parameter ini saat ini default ke 4.0.2). Parameter ini harus cocok dengan pustaka SDK server yang sebenarnya di build server game. Jika Anda menentukan versi yang salah untuk build server game yang diunggah, armada apa pun yang Anda buat dengan build tersebut akan gagal. Lihat [Buat build server game untuk Amazon GameLift Servers](gamelift-build-cli-uploading.md).

   Contoh berikut menggambarkan cara menentukan versi SDK 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. Jika Anda menggunakan skrip untuk terhubung dari jarak jauh ke armada terkelola, perbarui skrip untuk menggunakan proses baru, seperti yang dijelaskan dalam. [Connect ke instance armada](fleets-remote-access.md)