步骤 1：为本教程进行设置步骤 2：创建项目步骤 3：编写代码步骤 4：构建并运行应用程序后续步骤

开始使用适用于 Kotlin 的开发工具包

为每个 AWS SDK for Kotlin AWS 服务提供了 Kotlin APIs 。使用软件开发工具包，您可以构建适用于亚马逊 S3、亚马逊 EC2、亚马逊 DynamoDB 等的 Kotlin 应用程序。

本教程向您展示如何使用 Gradle 定义依赖关系。 AWS SDK for Kotlin然后，您可以创建将数据写入 DynamoDB 表的代码。尽管您可能想使用 IDE 的功能，但本教程所需要的只是一个终端窗口和一个文本编辑器。

要完成本教程，请执行以下步骤：

步骤 1：为本教程进行设置
步骤 2：创建项目
步骤 3：编写代码
步骤 4：构建并运行应用程序

步骤 1：为本教程进行设置

在开始本教程之前，您需要一个可以访问 DynamoDB 的 IAM 身份中心权限集，并且需要配置有 IAM 身份中心单点登录设置的 Kotlin 开发环境才能访问。 AWS

按照本指南基本设置中的说明进行操作，获取本教程的基础设置。

在将开发环境配置为 Kotlin SDK 的单点登录访问权限并且AWS 访问门户会话处于活动状态后，请继续步骤 2。

步骤 2：创建项目

要为本教程创建项目，请先使用 Gradle 为 Kotlin 项目创建基本文件。然后，使用所需的设置、依赖关系和代码更新文件 AWS SDK for Kotlin。

使用 Gradle 创建新项目

注意

本教程使用 Gradle 版本 8.11.1 和gradle init命令，该命令在下面的步骤 3 中提供了五个提示。如果您使用不同版本的 Gradle，则提示可能会有所不同，预先填充的工件版本也会有所不同。

getstarted在您选择的位置（例如桌面或主文件夹）创建一个名为的新目录。
打开终端或命令提示符窗口，然后导航到您创建的getstarted目录。
使用以下命令创建一个新的 Gradle 项目和一个基本的 Kotlin 类。
```
gradle init --type kotlin-application --dsl kotlin
```
- 当提示输入目标时Java version，按Enter（默认为21）。
- 出现提示时Project name，按Enter（在本教程getstarted中默认为目录名称）。
- 出现提示时application structure，按Enter（默认为Single application project）。
- 出现提示时Select test framework，按Enter（默认为kotlin.test）。
- 出现提示时Generate build using new APIs and behavior，按Enter（默认为no）。

使用 AWS SDK for Kotlin 和 Amazon S3 的依赖项配置您的项目

在上一个过程中创建的getstarted目录中，将settings.gradle.kts文件内容替换为以下内容，X.Y.Z替换为最新版本的 Kotlin SDK：


dependencyResolutionManagement {
    repositories {
        mavenCentral()
    }

    versionCatalogs {
        create("awssdk") {
            from("aws.sdk.kotlin:version-catalog:X.Y.Z")
        }
    }
}

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")

导航到该gradle目录内的getstarted目录。将名libs.versions.toml为的版本目录文件的内容替换为以下内容：


[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" }

导航到 app 目录并打开 build.gradle.kts 文件。用下面的代码替换相关内容，然后保存更改。


plugins {
    alias(libs.plugins.kotlin.jvm)
    application
}


dependencies {
    implementation(awssdk.services.s3) // Add dependency on the AWS SDK for 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>("test") {
    useJUnitPlatform()
}

该dependencies部分包含的 Amazon S3 模块的implementation条目 AWS SDK for Kotlin。java在本节中，Gradle 编译器被配置为使用 Java 21。

步骤 3：编写代码

创建和配置项目后，编辑项目的默认类App以使用以下示例代码。

在您的项目文件夹中app，导航到该目录src/main/kotlin/org/example。打开 App.kt文件。

将其内容替换为以下代码并保存该文件。


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!")
}

步骤 4：构建并运行应用程序

创建包含示例类的项目后，生成并运行该应用程序。

打开终端或命令提示符窗口并导航至您的项目目录 getstarted。
使用以下命令来构建和运行您的应用程序：
```
gradle run
```

注意

如果您获得IdentityProviderException，则可能没有有效的单点登录会话。运行 C aws sso login AWS LI 命令启动新会话。

该应用程序调用 CreateBucket API 操作来创建新的 S3 存储桶，然后调用 Puto Bjec t 将新对象放入新的 S3 存储桶。

在最后的cleanUp()函数中，应用程序删除对象，然后删除 S3 存储桶。

在 Amazon S3 控制台中查看结果

在中App.kt，注释掉该runBlocking部分cleanUp(s3)中的行并保存该文件。
通过运行重建项目并将新对象放入新的 S3 存储桶中gradle run。
登录 Amazon S3 控制台，查看新 S3 存储桶中的新对象。

查看对象后，删除 S3 存储桶。

成功

如果你的 Gradle 项目构建并运行时没有错误，那么恭喜你。您已经使用成功构建了您的第一个 Kotlin 应用程序。 AWS SDK for Kotlin

清理

开发完新应用程序后，请删除在本教程中创建的所有 AWS 资源，以免产生任何费用。您可能还想删除或存档在步骤 2 中创建的项目文件夹 (get-started)。

请按照以下步骤清理资源：

如果您注释掉了对该cleanUp()函数的调用，请使用 Amazon S3 控制台删除 S3 存储桶。

后续步骤

现在您已掌握了基础知识，接下来，您可以了解以下内容：

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

文档惯例

那是什么 AWS SDK for Kotlin？

设置