Skip to content

Commit

Permalink
Update translated readmes. (#2626)
Browse files Browse the repository at this point in the history 
* Update translated readmes.

* Update Swedish.

* Spacing.
  • Loading branch information
@colinrtwhite
colinrtwhite authored Nov 1, 2024
1 parent 7b29c92 commit 0582d75
Show file tree
Hide file tree
Showing 7 changed files with 71 additions and 544 deletions.
100 changes: 11 additions & 89 deletions README-ja.md
View file
Original file line number Diff line number Diff line change
@@ -1,57 +1,24 @@
![Coil](logo.svg)

Coil は Kotlin Coroutines で作られた Android 用の画像読み込みライブラリです。 Coil は:
[Android](https://www.android.com/) および [Compose Multiplatform](https://www.jetbrains.com/lp/compose-multiplatform/) 用の画像読み込みライブラリ。Coil の特徴:

- **高速**: Coil は、メモリとディスクのキャッシング、メモリ内の画像のダウンサンプリング、リクエストの一時停止/キャンセルの自動化など、多くの最適化を実行します。
- **軽量**: Coil は ~2000 のメソッドを APK に追加します (すでに OkHttp と Coroutines を使用しているアプリの場合)。これは Picasso に匹敵し、Glide や Fresco よりも大幅に少ない数です。
- **使いやすい**: Coil の API は、ボイラープレートの最小化とシンプルさのために Kotlin の言語機能を活用しています。
- **現代的**: Coil は Kotlin ファーストで、Coroutines、OkHttp、Okio、AndroidX Lifecycles などの最新のライブラリを使用します。
- **高速**: Coil は、メモリとディスクのキャッシュ、画像のダウンサンプリング、リクエストの自動一時停止/キャンセルなど、さまざまな最適化を実行します。
- **軽量**: Coil は Kotlin、Coroutines、Okio のみに依存し、Google の R8 コード シュリンカーとシームレスに連携します。
- **使いやすい**: Coil の API は、シンプルさと最小限の定型文を実現するために Kotlin の言語機能を活用しています。
- **最新**: Coil は Kotlin ファーストであり、Compose、Coroutines、Okio、OkHttp、Ktor などの最新のライブラリと相互運用できます。

Coil は **Co**routine **I**mage **L**oader の頭字語です。

## ダウンロード

Coil は `mavenCentral()` で利用できます。

```kotlin
implementation("io.coil-kt:coil:2.7.0")
```
Coil は、**Co**routine **I**mage **L**oader の頭字語です。

## クイックスタート

#### ImageViews

画像を `ImageView` に読み込むには、 `load` 拡張関数を使用します。

```kotlin
// URL
imageView.load("https://example.com/image.jpg")

// File
imageView.load(File("/path/to/image.jpg"))

// And more...
```

Requests は、 trailing lambda 式を使用して追加の設定を行うことができます:

```kotlin
imageView.load("https://example.com/image.jpg") {
crossfade(true)
placeholder(R.drawable.image)
transformations(CircleCropTransformation())
}
```

#### Jetpack Compose

[Jetpack Compose](https://developer.android.com/jetpack/compose) 拡張ライブラリをインポートします:
Compose ライブラリと [ネットワーク ライブラリ](https://coil-kt.github.io/coil/network/) をインポートします:

```kotlin
implementation("io.coil-kt:coil-compose:2.7.0")
implementation("io.coil-kt.coil3:coil-compose:3.0.0-rc02")
implementation("io.coil-kt.coil3:coil-network-okhttp:3.0.0-rc02")
```

画像を読み込むには、`AsyncImage` composable を使用します:
画像を読み込むには、`AsyncImage` を使用しますcomposable:

```kotlin
AsyncImage(
Expand All @@ -60,52 +27,7 @@ AsyncImage(
)
```

#### Image Loaders

`imageView.load` と `AsyncImage` はシングルトンの `ImageLoader` を使用して画像リクエストを実行します。 シングルトンの `ImageLoader` には `Context` 拡張関数を使用してアクセスできます:

```kotlin
val imageLoader = context.imageLoader
```

`ImageLoader` は共有できるように設計されており、単一のインスタンスを作成してアプリ全体で共有すると最も効率的です。 また、独自の `ImageLoader` インスタンスを作成することもできます:

```kotlin
val imageLoader = ImageLoader(context)
```

シングルトンの `ImageLoader` が必要ない場合は、 `io.coil-kt:coil` の代わりに `io.coil-kt:coil-base` を使用してください。

#### Requests

画像をカスタムターゲットにロードするには、 `ImageRequest` を `enqueue` してください:

```kotlin
val request = ImageRequest.Builder(context)
.data("https://example.com/image.jpg")
.target { drawable ->
// Handle the result.
}
.build()
val disposable = imageLoader.enqueue(request)
```

画像を命令的にロードするには、 `ImageRequest` を `execute` してください:

```kotlin
val request = ImageRequest.Builder(context)
.data("https://example.com/image.jpg")
.build()
val drawable = imageLoader.execute(request).drawable
```

[こちらで Coil の完全なドキュメント](https://coil-kt.github.io/coil/getting_started/) を確認してください。

## R8 / Proguard

Coil は R8 と完全に互換性があり、追加のルールを追加する必要はありません。

Proguardを使用している場合は、[Coroutines](https://github.com/Kotlin/kotlinx.coroutines/blob/master/kotlinx-coroutines-core/jvm/resources/META-INF/proguard/coroutines.pro)、[OkHttp](https://github.com/square/okhttp/blob/master/okhttp/src/jvmMain/resources/META-INF/proguard/okhttp3.pro)にルールを追加する必要があるかもしれません。
Coil の [完全なドキュメントはこちら](https://coil-kt.github.io/coil/getting_started/) をご覧ください。

## ライセンス

Expand Down
100 changes: 11 additions & 89 deletions README-ko.md
View file
Original file line number Diff line number Diff line change
@@ -1,57 +1,24 @@
![Coil](logo.svg)

Coil은 Kotlin Coroutines으로 만들어진 Android 백앤드 이미지 로딩 라이브러리입니다. Coil 은:
[Android](https://www.android.com/) 및 [Compose Multiplatform](https://www.jetbrains.com/lp/compose-multiplatform/)을 위한 이미지 로딩 라이브러리입니다. Coil의 특징은 다음과 같습니다.

- **빠르다**: Coil은 메모리와 디스크의 캐싱, 메모리의 이미지 다운 샘플링, Bitmap 재사용, 일시정지/취소의 자동화 등등 수 많은 최적화 작업을 수행합니다.
- **가볍다**: Coil은 최대 2000개의 method들을 APK에 추가합니다(이미 OkHttp와 Coroutines을 사용중인 앱에 한하여), 이는 Picasso 비슷한 수준이며 Glide와 Fresco보다는 적습니다.
- **사용하기 쉽다**: Coil API는 심플함과 최소한의 boilerplate를 위하여 Kotlin의 기능을 활용합니다.
- **현대적이다**: Coil은 Kotlin 우선이며 Coroutines, OkHttp, Okio, AndroidX Lifecycles등의 최신 라이브러리를 사용합니다.
- **빠름**: Coil은 메모리 및 디스크 캐싱, 이미지 다운샘플링, 요청 자동 일시 중지/취소 등 여러 가지 최적화를 수행합니다.
- **가벼움**: Coil은 Kotlin, Coroutines, Okio에만 의존하며 Google의 R8 코드 축소기와 원활하게 작동합니다.
- **사용하기 쉬움**: Coil의 API는 Kotlin의 언어 기능을 활용하여 단순성과 최소한의 보일러플레이트를 제공합니다.
- **현대적**: Coil은 Kotlin을 우선으로 하며 Compose, Coroutines, Okio, OkHttp, Ktor를 포함한 최신 라이브러리와 상호 운용됩니다.

Coil은: **Co**routine **I**mage **L**oader의 약자입니다.

## 다운로드

Coil은 `mavenCentral()`로 이용 가능합니다.

```kotlin
implementation("io.coil-kt:coil:2.7.0")
```
코일은 **Co**routine **I**mage **L**oader**의 약자입니다.

## 빠른 시작

#### ImageViews

`ImageView`로 이미지를 불러오기 위해, `load` 확장 함수를 사용합니다.

```kotlin
// URL
imageView.load("https://example.com/image.jpg")

// File
imageView.load(File("/path/to/image.jpg"))

// And more...
```

Requests는 trailing lambda 식을 이용하여 추가 설정을 할 수 있습니다:

```kotlin
imageView.load("https://example.com/image.jpg") {
crossfade(true)
placeholder(R.drawable.image)
transformations(CircleCropTransformation())
}
```

#### Jetpack Compose

[Jetpack Compose](https://developer.android.com/jetpack/compose) 확장 라이브러리 추가:
Compose 라이브러리와 [네트워킹 라이브러리](https://coil-kt.github.io/coil/network/ 가져오기:

```kotlin
implementation("io.coil-kt:coil-compose:2.7.0")
구현("io.coil-kt.coil3:coil-compose:3.0.0-rc02")
구현("io.coil-kt.coil3:coil-network-okhttp:3.0.0-rc02")
```

이미지를 불러오려면, `AsyncImage` composable를 사용하세요:
이미지를 로드하려면 `AsyncImage`를 사용하세요. 구성 가능:

```kotlin
AsyncImage(
Expand All @@ -60,52 +27,7 @@ AsyncImage(
)
```

#### Image Loaders

`imageView.load` 와 `AsyncImage`는 이미지를 불러오기 위해 싱글톤 `ImageLoader`를 사용합니다. 싱글톤 `ImageLoader`는 `Context`의 확장함수를 통해 접근할 수 있습니다:

```kotlin
val imageLoader = context.imageLoader
```

`ImageLoader`는 공유가 가능하게 설계 되었으며, 싱글 객체를 만들어서 앱에 전반적으로 사용했을 때 가장 효율적입니다. 즉, 직접 `ImageLoader` 인스턴스를 생성해도 됩니다:

```kotlin
val imageLoader = ImageLoader(context)
```

싱글톤 `ImageLoader`를 사용하고 싶지 않을때에는, `io.coil-kt:coil`를 참조하는 대신, `io.coil-kt:coil-base`를 참조하세요.

#### Requests

커스텀 타겟에 이미지를 로드하려면, `ImageRequest`를 `enqueue` 하세요:

```kotlin
val request = ImageRequest.Builder(context)
.data("https://example.com/image.jpg")
.target { drawable ->
// Handle the result.
}
.build()
val disposable = imageLoader.enqueue(request)
```

Imperative하게 이미지 로드를 하려면, `ImageRequest`를 `execute` 하세요:

```kotlin
val request = ImageRequest.Builder(context)
.data("https://example.com/image.jpg")
.build()
val drawable = imageLoader.execute(request).drawable
```

[여기서 Coil의 전체 문서](https://coil-kt.github.io/coil/)를 확인하세요.

## R8 / Proguard

Coil은 별도의 설정 없이 R8과 완벽하게 호환 가능하며 추가 규칙이 필요하지 않습니다.

Proguard를 사용할 경우, [Coroutines](https://github.com/Kotlin/kotlinx.coroutines/blob/master/kotlinx-coroutines-core/jvm/resources/META-INF/proguard/coroutines.pro)와 [OkHttp](https://github.com/square/okhttp/blob/master/okhttp/src/jvmMain/resources/META-INF/proguard/okhttp3.pro)의 규칙을 추가할 필요가 있을 수 있습니다.
Coil의 [전체 문서는 여기에서](https://coil-kt.github.io/coil/getting_started/)에서 확인하세요.

## 라이선스

Expand Down
102 changes: 12 additions & 90 deletions README-ru.md
View file
Original file line number Diff line number Diff line change
@@ -1,57 +1,24 @@
![Coil](logo.svg)

Библиотека для загрузки изображений на Android, работающая с корутинами Kotlin. Coil - это:
Библиотека загрузки изображений для [Android](https://www.android.com/) и [Compose Multiplatform](https://www.jetbrains.com/lp/compose-multiplatform/). Coil:

- **Скорость**: Coil выполняет оптимизации, включая кэширование в памяти и на диске, уменьшение дискретизации изображения в памяти, автоматическая приостановка/отмена запросов, и многое другое.
- **Маленький вес**: Coil добавляет ~2000 методов в ваш APK (для приложений, уже пользующихся OkHttp и корутинами), что сравнимо с Picasso и гораздо меньше, чем Glide и Fresco.
- **Простота в использовании**: API Coil использует преимущества Kotlin, чтобы уменьшить количество повторяющегося кода.
- **Современность**: Coil в первую очередь предназначен для Kotlin и использует современные библиотеки, включая корутины, OkHttp, Okio, и AndroidX Lifecycles.
- **Быстрая**: Coil выполняет ряд оптимизаций, включая кэширование памяти и диска, понижение разрешения изображения, автоматическую приостановку/отмену запросов и многое другое.
- **Легкая**: Coil зависит только от Kotlin, Coroutines и Okio и без проблем работает с укоротителем кода R8 от Google.
- **Простая в использовании**: API Coil использует возможности языка Kotlin для простоты и минимального шаблона.
- **Современная**: Coil ориентирована на Kotlin и взаимодействует с современными библиотеками, включая Compose, Coroutines, Okio, OkHttp и Ktor.

Coil - аббревиатура: **Co**routine **I**mage **L**oader (загрузчик изображений при помощи корутин).
Coil — это аббревиатура от: **Co**routine **I**mage **L**loader.

## Установка
## Быстрый старт

Coil доступен в `mavenCentral()`.
Импортируйте библиотеку Compose и [сетевую библиотеку](https://coil-kt.github.io/coil/network/):

```kotlin
implementation("io.coil-kt:coil:2.7.0")
implementation("io.coil-kt.coil3:coil-compose:3.0.0-rc02")
implementation("io.coil-kt.coil3:coil-network-okhttp:3.0.0-rc02")
```

## Начало работы

#### ImageViews

Чтобы загрузить изображение в `ImageView`, воспользуйтесь расширением `load`:

```kotlin
// URL
imageView.load("https://example.com/image.jpg")

// Файл
imageView.load(File("/path/to/image.jpg"))

// И многое другое...
```

Запросы могут конфигурироваться лямбда-функцией:

```kotlin
imageView.load("https://example.com/image.jpg") {
crossfade(true)
placeholder(R.drawable.image)
transformations(CircleCropTransformation())
}
```

#### Jetpack Compose

Установите библиотеку-расширение для [Jetpack Compose](https://developer.android.com/jetpack/compose):

```kotlin
implementation("io.coil-kt:coil-compose:2.7.0")
```

Чтобы загрузить изображение, воспользуйтесь composable-функцией `AsyncImage`:
Чтобы загрузите изображение, используйте `AsyncImage` composable:

```kotlin
AsyncImage(
Expand All @@ -60,52 +27,7 @@ AsyncImage(
)
```

#### Загрузчики изображений

Как `imageView.load`, так и `AsyncImage` используют синглтон `ImageLoader` для исполнения запросов на загрузку. Синглтон `ImageLoader` доступен через расширение `Context`:

```kotlin
val imageLoader = context.imageLoader
```

`ImageLoader`ы максимально эффективны, когда во всем приложении используется один и тот же его экземпляр. Тем не менее, вы можете создавать и свои экземпляры `ImageLoader`, если потребуется:

```kotlin
val imageLoader = ImageLoader(context)
```

Если вам не требуется синглтон `ImageLoader`, используйте `io.coil-kt:coil-base` вместо `io.coil-kt:coil`.

#### Запросы

Чтобы загрузить изображение в заданную цель, выполните метод `enqueue` на `ImageRequest`:

```kotlin
val request = ImageRequest.Builder(context)
.data("https://example.com/image.jpg")
.target { drawable ->
// Распоряжайтесь результатом.
}
.build()
val disposable = imageLoader.enqueue(request)
```

Чтобы загрузить изображение императивно, выполните `execute` на `ImageRequest`:

```kotlin
val request = ImageRequest.Builder(context)
.data("https://example.com/image.jpg")
.build()
val drawable = imageLoader.execute(request).drawable
```

Полную документацию для Coil можно найти [здесь](https://coil-kt.github.io/coil/getting_started/).

## R8 / Proguard

Coil полностью совместим с R8 "из коробки" и не требует дополнительной настройки.

Если вы используете Proguard, вам может понадобиться добавить правила для [корутин](https://github.com/Kotlin/kotlinx.coroutines/blob/master/kotlinx-coroutines-core/jvm/resources/META-INF/proguard/coroutines.pro) и [OkHttp](https://github.com/square/okhttp/blob/master/okhttp/src/main/resources/META-INF/proguard/okhttp3.pro).
Ознакомьтесь с [полной документацией Coil] здесь (https://coil-kt.github.io/coil/getting_started/).

## Лицензия

Expand Down
Loading

0 comments on commit 0582d75

Please sign in to comment.