Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion content/docs/changelog/index.ko.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: 변경 이력
description: Webview Bundle 릴리스를 추적하는 곳이며, 지금까지 배포된 버전을 확인할 수 있습니다.
description: Webview Bundle 릴리스와 지금까지 배포된 버전을 추적합니다.
---

릴리스는 패키지별로 발행됩니다. 따라서 공식 릴리스 노트는 각 레지스트리와 GitHub 릴리스 페이지에 있습니다.
Expand Down
2 changes: 1 addition & 1 deletion content/docs/changelog/index.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Changelog
description: Where Webview Bundle releases are tracked, and the versions published so far.
description: Track Webview Bundle releases and the versions published so far.
---

Releases are cut per package, so the authoritative release notes live with each registry and the
Expand Down
2 changes: 1 addition & 1 deletion content/docs/config/index.ko.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -63,7 +63,7 @@ wvb pack --config ./configs/wvb.prod.ts
### defineConfig

설정을 `@wvb/config`의 `defineConfig`로 감싸세요. 이 함수는 런타임에서는 항등 함수이며,
타입을 붙이는 것이 유일한 역할입니다. 객체, 설정으로 해석되는 프로미스, 또는 설정을
타입을 붙이는 것이 유일한 역할입니다. 객체, 설정으로 이행되는 프로미스, 또는 설정을
반환하는 동기 혹은 비동기 함수를 받습니다. 따라서 불러오는 시점에 값을 계산할 수 있습니다.

<Tabs items={['Object', 'Async function']}>
Expand Down
4 changes: 2 additions & 2 deletions content/docs/config/remote.ko.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -161,8 +161,8 @@ signature: async ({ message }) => myExternalSigner(message),

<Callout type="info">
클라이언트는 대응하는 **공개** 키로 검증하며, 검증 측은 서명 측과 다른 키 포맷을 받습니다. SPKI,
PKCS#1(RSA 전용), SEC1(ECDSA 전용), raw 32바이트(Ed25519 전용)를 받지만 JWK는 받지 않습니다.
검증에 대해서는 [원격 번들](/docs/guide/remote-bundles)을, 클라이언트 측 헬퍼에 대해서는 [Node API
PKCS#1(RSA 전용), SEC1(ECDSA 전용), raw 32바이트(Ed25519 전용)를 받지만 JWK는 받지 않습니다. 검증
방법은 [원격 번들](/docs/guide/remote-bundles)을, 클라이언트 측 헬퍼는 [Node API
레퍼런스](/docs/references/node)를 참고하세요.
</Callout>

Expand Down
2 changes: 1 addition & 1 deletion content/docs/guide/bundle-sources.ko.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -86,7 +86,7 @@ description: Webview Bundle이 builtin 및 remote 소스에 걸쳐 번들을 디
| `entries.{name}.currentVersion` | string (optional) | 이 번들에 대해 제공되는 활성 버전입니다. |
| `entries.{name}.previousVersion` | string (optional) | 현재 버전 직전에 활성이었던 버전입니다. |

각 버전의 메타데이터는 모든 필드가 선택 사항인 객체입니다. 빈 `{}`도 유효합니다. 메타데이터는 번들을 다운로드할 때 remote 서버의 응답 헤더로부터만 채워지기 때문입니다.
각 버전의 메타데이터는 모든 필드가 선택 사항인 객체입니다. 빈 `{}`도 유효합니다. 메타데이터는 번들을 다운로드할 때 remote 서버의 응답 헤더에서만 채워지기 때문입니다.

| Field | Type | Description |
| -------------- | ------ | ------------------------------------------------------------- |
Expand Down
2 changes: 1 addition & 1 deletion content/docs/guide/cli-programmatic.ko.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -63,7 +63,7 @@ yarn add -D @wvb/cli

### pack

소스 디렉터리를 `.wvb` 아카이브로 패킹합니다. `outFile` 확장자를 생략하면 `.wvb` 확장자가 자동으로
소스 디렉터리를 `.wvb` 아카이브로 패킹합니다. `outFile`에서 확장자를 생략하면 `.wvb` 확장자가 자동으로
붙습니다.

```ts
Expand Down
4 changes: 2 additions & 2 deletions content/docs/guide/cli.ko.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -54,7 +54,7 @@ yarn wvb --help

## 설정 파일 탐색

명령어는 작업 디렉터리에 있는 `wvb.config` 파일에서 기본값을 로드합니다. 특정 파일을 가리키려면 `--config <path>`를 전달하세요. 전달하지 않으면 `wvb`는 다음 순서로 첫 번째로 일치하는 파일을 찾습니다.
명령어는 작업 디렉터리에 있는 `wvb.config` 파일에서 기본값을 로드합니다. 특정 파일을 가리키려면 `--config <path>`를 전달하세요. 전달하지 않으면 `wvb`는 다음 순서에 따라 첫 번째로 일치하는 파일을 찾습니다.

```text
wvb.config.js
Expand Down Expand Up @@ -111,7 +111,7 @@ wvb.config.jsonc
<Card
title="wvb builtin"
href="/docs/guide/commands/builtin"
description="배포된 번들을 로컬에 설치해 내장 폴백으로 함께 배포합니다."
description="배포된 번들을 로컬에 설치해 빌트인 폴백으로 함께 배포합니다."
/>
<Card
title="wvb remote"
Expand Down
8 changes: 4 additions & 4 deletions content/docs/guide/commands/builtin.ko.mdx
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
---
title: wvb builtin
description: 원격 또는 로컬 대상에서 내장 웹뷰 번들을 앱에 설치합니다.
description: 원격 또는 로컬 대상에서 빌트인 웹뷰 번들을 앱에 설치합니다.
---

`wvb builtin`은 앱이 내장 폴백으로 함께 배포할 수 있도록 번들을 출력 디렉터리에 설치합니다. 앱이 오프라인으로 시작하거나 무선(OTA)으로 더 새로운 번들을 가져오기 전에는 이 내장 번들을 제공합니다. 이 명령어는 [설정](/docs/config)의 `builtin.target`에 정의된 소스에서 번들을 가져오며, 기본값은 원격 대상입니다.
`wvb builtin`은 앱이 빌트인 폴백으로 함께 배포할 수 있도록 번들을 출력 디렉터리에 설치합니다. 앱이 오프라인으로 시작하거나 무선(OTA)으로 더 새로운 번들을 가져오기 전에는 이 빌트인 번들을 제공합니다. 이 명령어는 [설정](/docs/config)의 `builtin.target`에 정의된 소스에서 번들을 가져오며, 기본값은 원격 대상입니다.

이 명령어는 설치된 번들 집합을 설명하는 `manifest.json`과, 번들마다 `<name>/<name>_<version>.wvb` 형태로 배치된 파일을 하나씩 기록합니다. 내장 소스와 원격 소스가 함께 동작하는 방식은 [번들 소스](/docs/guide/bundle-sources)를 참고하세요.
이 명령어는 설치된 번들 집합을 설명하는 `manifest.json`과, 번들마다 `<name>/<name>_<version>.wvb` 형태로 배치된 파일을 하나씩 기록합니다. 빌트인 소스와 원격 소스가 함께 동작하는 방식은 [번들 소스](/docs/guide/bundle-sources)를 참고하세요.

## Usage

Expand Down Expand Up @@ -69,7 +69,7 @@ wvb builtin --no-write
<Card
title="번들 소스"
href="/docs/guide/bundle-sources"
description="내장 소스와 원격 소스, 매니페스트, 채널이 어떻게 맞물리는지 설명합니다."
description="빌트인 소스와 원격 소스, 매니페스트, 채널이 어떻게 맞물리는지 설명합니다."
/>
<Card
title="wvb download"
Expand Down
2 changes: 1 addition & 1 deletion content/docs/guide/commands/deploy.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ The global flags `--color`, `--log-level`, and `--log-verbose` also apply. See t

## Requirements

`deploy` requires `remote.deployer` in your [config](/docs/config/remote). The deployer is the component that records which version is current on the remote, so a remote without one cannot be deployed to.
`deploy` requires `remote.deployer` in your [config](/docs/config/remote). The deployer is the component that records which version is current on the remote, so you cannot deploy to a remote without one.

<Callout type="info">
The version is the `--version` (`-V`) flag, not a positional argument. If you omit it, deploy uses
Expand Down
2 changes: 1 addition & 1 deletion content/docs/guide/commands/download.ko.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ wvb download app --no-write

첫 번째 예제는 현재 배포된 `app` 버전을 작업 디렉터리의 `app.wvb`로 다운로드합니다. 두 번째 예제는 특정 버전(`1.2.0`)을 명시한 경로로 다운로드하며, 기존 파일이 있으면 덮어씁니다. 세 번째 예제는 번들을 가져와 정보를 출력하되 디스크에는 아무것도 쓰지 않습니다.

번들 이름과 엔드포인트는 모두 [`wvb.config`](/docs/config/remote) 파일 값으로 대체되므로, 설정이 갖춰진 프로젝트 안에서는 보통 플래그 없이 `wvb download`만 실행해 현재 버전을 가져올 수 있습니다.
번들 이름과 엔드포인트는 모두 [`wvb.config`](/docs/config/remote) 파일 값을 기본값으로 사용하므로, 설정이 갖춰진 프로젝트 안에서는 보통 플래그 없이 `wvb download`만 실행해 현재 버전을 가져올 수 있습니다.

## Options

Expand Down
2 changes: 1 addition & 1 deletion content/docs/guide/commands/download.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: wvb download
description: Download a bundle from a remote server to disk, or fetch and print its metadata.
---

`wvb download` fetches a bundle from a remote server and, by default, saves it to disk as a `.wvb` file. Pass a bundle name and an optional version; omit the version to download the version that is currently deployed. This is the read side of the publishing workflow that `wvb upload` and `wvb deploy` drive, and it is handy for verifying what a remote actually serves.
`wvb download` fetches a bundle from a remote server and, by default, saves it to disk as a `.wvb` file. Pass a bundle name and an optional version; omit it to download the version that is currently deployed. This is the read side of the publishing workflow that `wvb upload` and `wvb deploy` drive, and it is handy for verifying what a remote actually serves.

## Usage

Expand Down
2 changes: 1 addition & 1 deletion content/docs/guide/commands/pack.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: wvb pack
description: Pack a directory of built web assets into a single compressed, integrity-checked .wvb archive.
---

`wvb pack` packs a directory of built web assets (HTML, JS, CSS, media) into a single `.wvb` archive. The archive is compressed and checksummed, and it is the unit your app ships and serves to its webview, or uploads to a remote for over-the-air (OTA) updates.
`wvb pack` packs a directory of built web assets (HTML, JS, CSS, media) into a single `.wvb` archive. The archive is compressed and checksummed. It is the unit your app ships and serves to its webview, or uploads to a remote for over-the-air (OTA) updates.

Most projects run `wvb pack` with no arguments. The source directory, output path, and other defaults come from the [`wvb.config`](/docs/config) file discovered in the working directory.

Expand Down
4 changes: 2 additions & 2 deletions content/docs/guide/index.ko.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ description: 웹뷰 기반 프레임워크와 플랫폼을 위한 오프라인
Webview Bundle(`wvb`)은 빌드한 웹 자산(HTML/JS/CSS/미디어)을 압축되고 무결성이 검증된 단일
아카이브(`.wvb`)로 묶습니다. 앱은 이 아카이브를 함께 배포하고, 커스텀 URL 스킴을 통해 웹뷰에
제공합니다. 따라서 첫 화면은 네트워크를 기다리지 않습니다. 원격 서버를 설정하면 앱이 더 새로운
번들을 무선(OTA, over-the-air)으로 내려받아, 네이티브 앱스토어 배포 없이 갱신된 코드를
번들을 무선(OTA, over-the-air)으로 다운로드하여, 네이티브 앱스토어 배포 없이 갱신된 코드를
전달합니다. 하나의 `.wvb` 포맷이 공유 Rust 코어를 통해 모든 웹뷰 플랫폼에서 동작합니다.

![빌드 산출물을 .wvb 아카이브로 묶어 웹뷰에 제공하고, 원격 서버에서 무선으로 갱신합니다.](https://static.wvb.dev/diagrams/pack-serve-update.svg)
Expand Down Expand Up @@ -43,7 +43,7 @@ yarn add -D @wvb/cli
# ./dist를 .wvb/<pkgName>으로 묶습니다 (--outfile,-O로 변경).
npx wvb pack

# http://localhost:4312에서 로컬 미리보기용으로 번들을 제공합니다.
# http://localhost:4312에서 로컬 미리 보기용으로 번들을 제공합니다.
npx wvb serve
```

Expand Down
2 changes: 1 addition & 1 deletion content/docs/guide/platform-support.ko.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -122,7 +122,7 @@ webView.load(URLRequest(url: URL(string: "app://app.wvb")!))

## Deno Desktop

Deno Desktop은 가장 최신 통합이며, JSR에 `@wvb/deno-desktop` 올라와 있습니다. 번들 소스를 빌드하고 `Deno.serve` 호환 핸들러를 노출하며, 윈도우마다 하나의 프로토콜을 사용합니다.
Deno Desktop은 가장 최신 통합이며, JSR에 `@wvb/deno-desktop`으로 올라와 있습니다. 번들 소스를 빌드하고 `Deno.serve` 호환 핸들러를 노출하며, 윈도우마다 하나의 프로토콜을 사용합니다.

<Callout type="info">
Deno Desktop은 실험적입니다. [Deno Desktop 가이드](/docs/guide/platforms/deno)와 [Deno API
Expand Down
4 changes: 2 additions & 2 deletions content/docs/guide/platforms/android.ko.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -108,7 +108,7 @@ wvb(context, config) // 짧은 별칭

## 파일 제공 동작 방식

커스텀 URL 스킴은 등록되지 않습니다. `install()`은 `WebViewClient`를 설정하며, 이 클라이언트의 `shouldInterceptRequest`가 일반적인 `http`/`https` 요청을 검사해 일치하는 요청을 번들 소스에서 제공합니다. 각 요청마다 핸들러는 호스트를 소문자로 바꾼 뒤 등록된 프로토콜을 순서대로 살펴봅니다. 호스트를 처음으로 받아들이는 매처가 승리합니다. 번들 프로토콜은 첫 번째 호스트 레이블을 번들 이름으로 삼고, 요청 경로에 해당하는 파일을 반환합니다. 일치하는 것이 없으면 `null`을 반환하고 `WebView`는 네트워크에서 로드합니다.
커스텀 URL 스킴은 등록되지 않습니다. `install()`은 `WebViewClient`를 설정하며, 이 클라이언트의 `shouldInterceptRequest`가 일반적인 `http`/`https` 요청을 검사해 일치하는 요청을 번들 소스에서 제공합니다. 각 요청마다 핸들러는 호스트를 소문자로 바꾼 뒤 등록된 프로토콜을 순서대로 살펴봅니다. 호스트를 처음으로 받아들이는 매처가 선택됩니다. 번들 프로토콜은 첫 번째 호스트 레이블을 번들 이름으로 삼고, 요청 경로에 해당하는 파일을 반환합니다. 일치하는 것이 없으면 `null`을 반환하고 `WebView`는 네트워크에서 로드합니다.

핸들러가 예외를 던지면 라이브러리는 `500 text/plain` 응답을 만들고 선택적 `onError` 콜백을 호출합니다. 요청 경로가 `.wvb` 안의 파일로 어떻게 매핑되는지는 [프로토콜 처리](/docs/guide/protocol-handling)를 참고하세요.

Expand Down Expand Up @@ -179,7 +179,7 @@ WebViewBundleConfig(

## 프로토콜

프로토콜은 `WebView` 요청을 어떤 호스트에서 제공할지 결정합니다. 프로토콜은 `WebViewBundleConfig.protocols`에 등록하며, 순서대로 평가되어 처음 일치하는 것이 승리합니다. 따라서 `bundle()`은 모든 호스트에 일치하므로 **가장 마지막에 등록하세요**.
프로토콜은 `WebView` 요청을 어떤 호스트에서 제공할지 결정합니다. 프로토콜은 `WebViewBundleConfig.protocols`에 등록하며, 순서대로 평가되어 처음 일치하는 것이 선택됩니다. 따라서 `bundle()`은 모든 호스트에 일치하므로 **가장 마지막에 등록하세요**.

<Tabs items={['Bundle', 'Local']}>
<Tab value="Bundle">
Expand Down
4 changes: 2 additions & 2 deletions content/docs/guide/platforms/deno.ko.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ const win = new Deno.BrowserWindow({ url: `http://localhost:${server.addr.port}`
await win.closed;
```

`@wvb/deno-desktop` 통합 계층입니다. `@wvb/deno`는 [`@wvb/node`](/docs/references/node)의 FFI 짝으로, 공유 Rust 코어를 구동합니다.
`@wvb/deno-desktop` 통합 계층입니다. `@wvb/deno`는 [`@wvb/node`](/docs/references/node)의 FFI 짝으로, 공유 Rust 코어를 구동합니다.

## 구성 방식

Expand Down Expand Up @@ -151,7 +151,7 @@ deno run -A jsr:@wvb/deno/install --out vendor/wvb --target x86_64-unknown-linux

## 제한 사항

현재 Deno 바인딩에는 두 가지 공백이 있습니다.
현재 Deno 바인딩에는 두 가지 제약이 있습니다.

**커스텀 verifier 콜백은 지원하지 않습니다.** `Updater`는 **선언적** `signatureVerifier`만 받습니다. 이는 `algorithm`과 `key`를 가진 `SignatureVerifierOptions`입니다.

Expand Down
Loading