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. # Fangen Sie mit dem SDK für Kotlin an Das AWS SDK für Kotlin bietet Kotlin APIs für jeden AWS-Service. Mit dem SDK können Sie Kotlin-Anwendungen erstellen, die mit Amazon S3, Amazon EC2, Amazon DynamoDB und mehr funktionieren. Dieses Tutorial zeigt Ihnen, wie Sie Gradle verwenden, um Abhängigkeiten für zu definieren. AWS SDK für Kotlin Anschließend erstellen Sie Code, der Daten in eine DynamoDB-Tabelle schreibt. Obwohl Sie vielleicht die Funktionen einer IDE verwenden möchten, benötigen Sie für dieses Tutorial lediglich ein Terminalfenster und einen Texteditor. Gehen Sie wie folgt vor, um dieses Tutorial abzuschließen: + [Schritt 1: Richten Sie sich für dieses Tutorial ein](#get-started-setup) + [Schritt 2: Erstellen Sie das Projekt](#get-started-projectsetup) + [Schritt 3: Schreiben Sie den Code](#get-started-code) + [Schritt 4: Erstellen Sie die Anwendung und führen Sie sie aus](#get-started-run) ## Schritt 1: Einrichtung für dieses Tutorial Bevor Sie mit diesem Tutorial beginnen, benötigen Sie einen [IAM Identity Center-Berechtigungssatz](https://docs.aws.amazon.com/singlesignon/latest/userguide/permissionsetsconcept.html), der auf DynamoDB zugreifen kann, und Sie benötigen eine Kotlin-Entwicklungsumgebung, die mit IAM Identity Center Single Sign-On-Einstellungen konfiguriert ist, auf die Sie zugreifen können. AWS Folgen Sie den Anweisungen in diesem Handbuch, um die [Grundlegende Einrichtung](setup-basic-onetime-setup.md) Grundlagen für dieses Tutorial einzurichten. Nachdem Sie Ihre Entwicklungsumgebung mit [Single Sign-On-Zugriff](setup-basic-onetime-setup.md#setup-sso-access) für das Kotlin SDK konfiguriert haben und Sie eine [aktive AWS Access-Portal-Sitzung](setup-basic-onetime-setup.md#setup-login-sso) haben, fahren Sie mit Schritt 2 fort. ## Schritt 2: Erstellen des Projekts Um das Projekt für dieses Tutorial zu erstellen, verwenden Sie zunächst Gradle, um die Basisdateien für ein Kotlin-Projekt zu erstellen. Aktualisieren Sie dann die Dateien mit den erforderlichen Einstellungen, Abhängigkeiten und dem Code für. AWS SDK für Kotlin **Um ein neues Projekt mit Gradle zu erstellen** **Anmerkung** Dieses Tutorial verwendet Gradle Version 8.11.1 mit dem `gradle init` Befehl, der in Schritt 3 unten fünf Eingabeaufforderungen bietet. Wenn Sie eine andere Version von Gradle verwenden, können sich die Eingabeaufforderungen unterscheiden, ebenso wie die vorausgefüllten Versionen von Artefakten. 1. Erstellen Sie ein neues Verzeichnis mit einem Namen `getstarted` an einem Ort Ihrer Wahl, z. B. Ihrem Desktop oder Home-Ordner. 1. Öffnen Sie ein Terminal- oder Befehlszeilenfenster und navigieren Sie zu dem `getstarted` Verzeichnis, das Sie erstellt haben. 1. Verwenden Sie den folgenden Befehl, um ein neues Gradle-Projekt und eine grundlegende Kotlin-Klasse zu erstellen. ``` gradle init --type kotlin-application --dsl kotlin ``` + Wenn Sie nach dem Ziel gefragt werden`Java version`, drücken Sie `Enter` (Standardeinstellung). `21` + Wenn Sie dazu aufgefordert werden`Project name`, drücken Sie `Enter` (`getstarted`in diesem Tutorial wird standardmäßig der Verzeichnisname verwendet). + Wenn Sie dazu aufgefordert werden`application structure`, drücken Sie `Enter` (standardmäßig). `Single application project` + Wenn Sie dazu aufgefordert werden`Select test framework`, drücken Sie `Enter` (standardmäßig). `kotlin.test` + Wenn Sie dazu aufgefordert werden`Generate build using new APIs and behavior`, drücken Sie `Enter` (standardmäßig). `no` **Um Ihr Projekt mit Abhängigkeiten für Amazon S3 AWS SDK für Kotlin und Amazon S3 zu konfigurieren** + Ersetzen Sie in dem `getstarted` Verzeichnis, das Sie im vorherigen Verfahren erstellt haben, den Inhalt der `settings.gradle.kts` Datei durch den folgenden Inhalt und *X.Y.Z* ersetzen Sie ihn durch die [neueste Version](https://github.com/awslabs/aws-sdk-kotlin/releases/latest) des SDK für Kotlin: ``` dependencyResolutionManagement { repositories { mavenCentral() } versionCatalogs { create("awssdk") { from("aws.sdk.kotlin:version-catalog:[https://github.com/awslabs/aws-sdk-kotlin/releases/latest](https://github.com/awslabs/aws-sdk-kotlin/releases/latest)") } } } plugins { // Apply the foojay-resolver plugin to allow automatic download of JDKs. id("org.gradle.toolchains.foojay-resolver-convention") version "0.8.0" } rootProject.name = "getstarted" include("app") ``` + Navigieren Sie zu dem `gradle` Verzeichnis innerhalb des `getstarted` Verzeichnisses. Ersetzen Sie den Inhalt der benannten Versionskatalogdatei `libs.versions.toml` durch den folgenden Inhalt: ``` [versions] junit-jupiter-engine = "5.10.3" [libraries] junit-jupiter-engine = { module = "org.junit.jupiter:junit-jupiter-engine", version.ref = "junit-jupiter-engine" } [plugins] kotlin-jvm = { id = "org.jetbrains.kotlin.jvm", version = "2.1.0" } ``` + Navigieren Sie zu dem Verzeichnis `app` und öffnen Sie die Datei `build.gradle.kts`. Ersetzen Sie seinen Inhalt durch den folgenden Code und speichern Sie dann Ihre Änderungen. ``` plugins { alias(libs.plugins.kotlin.jvm) application } dependencies { implementation(awssdk.services.s3) // Add dependency on the AWS SDK für Kotlin's S3 client. testImplementation("org.jetbrains.kotlin:kotlin-test-junit5") testImplementation(libs.junit.jupiter.engine) testRuntimeOnly("org.junit.platform:junit-platform-launcher") } java { toolchain { languageVersion = JavaLanguageVersion.of(21) } } application { mainClass = "org.example.AppKt" } tasks.named("test") { useJUnitPlatform() } ``` Der `dependencies` Abschnitt enthält einen `implementation` Eintrag für das Amazon S3 S3-Modul von AWS SDK für Kotlin. Der Gradle-Compiler ist in diesem Abschnitt für die Verwendung von Java 2.1 konfiguriert. `java` ## Schritt 3: Schreiben des Codes Nachdem das Projekt erstellt und konfiguriert wurde, bearbeiten Sie die Standardklasse des Projekts, `App` um den folgenden Beispielcode zu verwenden. 1. Navigieren Sie in Ihrem Projektordner `app` zum Verzeichnis`src/main/kotlin/org/example`. Öffnen Sie die `App.kt` Datei. 1. Ersetzen Sie den Inhalt durch den folgenden Code und speichern Sie die Datei. ``` package org.example import aws.sdk.kotlin.services.s3.* import aws.sdk.kotlin.services.s3.model.BucketLocationConstraint import aws.smithy.kotlin.runtime.content.ByteStream import kotlinx.coroutines.runBlocking import java.util.UUID val REGION = "us-west-2" val BUCKET = "bucket-${UUID.randomUUID()}" val KEY = "key" fun main(): Unit = runBlocking { S3Client .fromEnvironment { region = REGION } .use { s3 -> setupTutorial(s3) println("Creating object $BUCKET/$KEY...") s3.putObject { bucket = BUCKET key = KEY body = ByteStream.fromString("Testing with the Kotlin SDK") } println("Object $BUCKET/$KEY created successfully!") cleanUp(s3) } } suspend fun setupTutorial(s3: S3Client) { println("Creating bucket $BUCKET...") s3.createBucket { bucket = BUCKET if (REGION != "us-east-1") { // Do not set location constraint for us-east-1. createBucketConfiguration { locationConstraint = BucketLocationConstraint.fromValue(REGION) } } } println("Bucket $BUCKET created successfully!") } suspend fun cleanUp(s3: S3Client) { println("Deleting object $BUCKET/$KEY...") s3.deleteObject { bucket = BUCKET key = KEY } println("Object $BUCKET/$KEY deleted successfully!") println("Deleting bucket $BUCKET...") s3.deleteBucket { bucket = BUCKET } println("Bucket $BUCKET deleted successfully!") } ``` ## Schritt 4: Anwendung erstellen und ausführen Nachdem das Projekt erstellt wurde und die Beispielklasse enthält, erstellen Sie die Anwendung und führen Sie sie aus. 1. Öffnen Sie ein Terminal- oder ein Befehlszeilenfenster und navigieren Sie zu Ihrem Projektverzeichnis `getstarted`. 1. Verwenden Sie den folgenden Befehl, um Ihre Anwendung zu erstellen und auszuführen: ``` gradle run ``` **Anmerkung** Wenn Sie eine erhalten`IdentityProviderException`, haben Sie möglicherweise keine aktive Single Sign-On-Sitzung. Führen Sie den `aws sso login` AWS CLI-Befehl aus, um eine neue Sitzung zu initiieren. Die Anwendung ruft den API-Vorgang [CreateBucket](https://docs.aws.amazon.com/sdk-for-kotlin/api/latest/s3/aws.sdk.kotlin.services.s3/create-bucket.html) auf, um einen neuen S3-Bucket zu erstellen, und ruft dann [PutObject](https://docs.aws.amazon.com/sdk-for-kotlin/api/latest/s3/aws.sdk.kotlin.services.s3/put-object.html) auf, um ein neues Objekt in den neuen S3-Bucket einzufügen. In der `cleanUp()` Funktion am Ende löscht die Anwendung das Objekt und anschließend den S3-Bucket. **Um die Ergebnisse in der Amazon S3 S3-Konsole zu sehen** 1. Kommentieren Sie die Zeile `cleanUp(s3)` im `runBlocking` Abschnitt aus und speichern Sie die Datei. `App.kt` 1. Erstellen Sie das Projekt neu und fügen Sie ein neues Objekt in einen neuen S3-Bucket ein, indem Sie Folgendes ausführen`gradle run`. 1. Melden Sie sich bei der [Amazon S3 S3-Konsole](https://console.aws.amazon.com/s3) an, um das neue Objekt im neuen S3-Bucket anzusehen. Nachdem Sie das Objekt angesehen haben, löschen Sie den S3-Bucket. ### Herzlichen Glückwunsch Wenn Ihr Gradle-Projekt ohne Fehler erstellt und ausgeführt wurde, dann herzlichen Glückwunsch. Sie haben erfolgreich Ihre erste Kotlin-Anwendung mit dem erstellt. AWS SDK für Kotlin ### Bereinigen Wenn Sie mit der Entwicklung Ihrer neuen Anwendung fertig sind, löschen Sie alle AWS Ressourcen, die Sie in diesem Tutorial erstellt haben, um Gebühren zu vermeiden. Möglicherweise möchten Sie auch den Projektordner (`get-started`), den Sie in Schritt 2 erstellt haben, löschen oder archivieren. Gehen Sie wie folgt vor, um Ressourcen zu bereinigen: + Wenn Sie den `cleanUp()` Funktionsaufruf auskommentiert haben, löschen Sie den S3-Bucket mithilfe der [Amazon S3 S3-Konsole](https://console.aws.amazon.com/s3). ## Nächste Schritte Nachdem Sie sich mit den Grundlagen vertraut gemacht haben, können Sie sich über Folgendes informieren: + [Zusätzliche Einrichtungsschritte für die Arbeit mit dem SDK für Kotlin](setup.md) + [Konfiguration des SDK für Kotlin](configuration.md) + [Verwenden des SDK für Kotlin](using.md) + [Sicherheit für das SDK für Kotlin](security.md)