deblan-mirror/wails
1
0
Fork 0
mirror of https://github.com/wailsapp/wails.git synced 2026-03-14 22:55:48 +01:00
Code Issues Projects Releases Packages Wiki Activity

feat: increase synchronized content

Browse source
This commit is contained in:
misitebao 2021-10-29 22:15:09 +08:00
commit 71cfdfc7c8
5 changed files with 58 additions and 35 deletions
Download patch file Download diff file Expand all files Collapse all files

8
website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/howdoesitwork.mdx
View file

@ -17,7 +17,7 @@ Wails 应用程序是一个带有一个 webkit 前端的标准的 Go 应用程
### 概述
主应用程序由对`wails.Run()`的调用组成. 它接受描述应用程序窗口大小、窗口标题、要使用的资源等的应用程序配置。基本应用程序可能如下所示：
主应用程序由对`wails.Run()`的调用组成. 它接受描述应用程序窗口大小、窗口标题、要使用的资源等应用程序配置。基本应用程序可能如下所示：
```go title="main.go"
package main
@ -85,7 +85,7 @@ func (b *App) Greet(name string) string {
#### 资源
`Assets` 选项是必须的，因为您不能拥有没有前端资源的 Wails 应用程序。这些资源可以是您希望在 Web 应用程序中找到的任何文件 - html、js、css、svg、png 等。
**不需要生成资源包**- 纯文件即可。当应用程序启动时，它将尝试从您的资源中加载`index.html`，并且那时起前端基本上将作为浏览器工作。值得注意的是 embed.FS，
**不需要生成资源包**- 纯文件即可。当应用程序启动时，它将尝试从您的资源中加载`index.html`，并且那时起前端基本上将作为浏览器工作。值得注意的是`embed.FS`，
文件所在的位置没有要求。嵌入路径很可能使用了相对于您的主应用程序代码的嵌套目录，例如 `frontend/dist`：
```go title="main.go"
@ -95,10 +95,10 @@ var assets embed.FS
启动时，Wails 将遍历嵌入的文件，寻找包含的`index.html`. 所有其他资源将相对于该目录加载。
由于生产二进制文件使用中包含在`embed.FS`的文件，因此应用程序不需要附带任何外部文件。
由于可用于生产的二进制文件使用包含在`embed.FS`中的文件，因此应用程序不需要附带任何外部文件。
当使用`wails dev`命令在”dev“模式下，资源从磁盘加载，任何更改都会导致“实时重新加载”。资源的位置需要使用`-assetdir`传递给`wails dev`命令，并且很可能与嵌入路径相同。
希望`embed.FS`将来我们可以从它本身计算出来。更多细节可以在[应用程序开发指南](/docs/guides/application-development)中找到。
希望将来我们可以从`embed.FS`本身计算出来。更多细节可以在[应用程序开发指南](/docs/guides/application-development)中找到。
#### 应用程序生命周期回调

64
website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/cli.mdx
View file

@ -13,25 +13,27 @@ Wails CLI 有许多用于管理项目的命令。所有命令都以此方式运
`wails init` 用于生成项目。
| 标志 | 描述 | 默认 |
| :----------------- | :------------------------------------------------------------------ | :------ |
| -n "project name" | 项目名. **强制必填**. | |
| -d "project dir" | 要创建的项目目录 | 项目名 |
| -g | 初始化 git 存储库 | |
| -l | 可用项目模板列表 | |
| -q | 禁止输出到控制台 | |
| -t "template name" | 要使用的项目模板。这可能是在 github 上托管的远程模板的 URL 的名称。 | vanilla |
| -ide | 生成 IDE 项目文件 | |
| -f | 强制构建应用 | false |
| 标志 | 描述 | 默认 |
| :----------------- | :---------------------------------------------------------------------------------- | :------ |
| -n "project name" | 项目名. **强制必填**. | |
| -d "project dir" | 要创建的项目目录 | 项目名 |
| -g | 初始化 git 存储库 | |
| -l | 可用项目模板列表 | |
| -q | 禁止输出到控制台 | |
| -t "template name" | 要使用的项目模板。这可能是默认模板的名称或在 github 上托管的远程模板的 URL 的名称。 | vanilla |
| -ide | 生成 IDE 项目文件 | |
| -f | 强制构建应用 | false |
示例：
`wails init -n test -d mytestproject -g -ide vscode -q`
这将在 "mytestproject" 目录生成一个名为 "test" 的项目，初始化 git，生成 vscode 项目文件并静默执行。
可以在[此处](/docs/guides/ides)找到有关在 Wails 中使用 IDE 的更多信息。
### 远程模板
支持远程模板（托管在 GitHub 上）并且可以使用模板的项目 URL 进行安装。
支持远程模板（托管在 GitHub 上）并且可以使用模板项目的 URL 进行安装。
示例： `wails init -n test -t https://github.com/leaanthony/testtemplate`
@ -66,6 +68,10 @@ Wails CLI 有许多用于管理项目的命令。所有命令都以此方式运
如果您更喜欢使用标准 Go 工具进行构建，请参阅[手动构建](/docs/guides/manual-builds)指南。
示例：
`wails build -clean -o myproject.exe`
## 诊断检查
`wails doctor` 将运行诊断程序以确保您的系统已准备好进行开发。
@ -111,23 +117,25 @@ Your system is ready for Wails development!
- 所有应用程序资源都从磁盘加载。如果它们被更改，应用程序将自动重新加载（而不是重新构建）。所有连接的浏览器也将重新加载
- 生成的 JS 模块提供以下内容：
- 带有自动生成的 JSDoc 的 Go 方法的 Javascript 包装器，提供代码提示
- 的 Go 结构体的 TypeScript 版本，可以构造并传递给您的后端方法
- 您的 Go 结构体的 TypeScript 版本，可以构造并传递给您的 Go 方法
- 生成第二个 JS 模块，为运行时提供包装器 + TS 声明
| 标志 | 描述 | 默认 |
| :--------------------------- | :---------------------------------------------------- | :-------------------------- |
| -assetdir "./path/to/assets" | 编译资源的路径 | Value in `wails.json` |
| -browser | `http://localhost:34115`在启动时打开浏览器 | |
| -compiler "compiler" | 使用不同的 go 编译器来构建，例如 go1.15beta1 | go |
| -e | 触发重建的扩展（逗号分隔） | go |
| -ldflags "flags" | 传递给编译器的额外 ldflags | |
| -tags "extra tags" | 构建标签以传递给编译器（引号和空格分隔） | |
| -loglevel "loglevel" | 要使用的日志级别 - Trace, Debug, Info, Warning, Error | Debug |
| -noreload | 资源更改时禁用自动重新加载 | |
| -v | 详细级别 (0 - silent, 1 - standard, 2 - verbose) | 1 |
| -wailsjsdir | 生成生成的 Wails JS 模块的目录 | Value store in `wails.json` |
| 标志 | 描述 | 默认 |
| :--------------------------- | :---------------------------------------------------- | :----------------------- |
| -assetdir "./path/to/assets" | 编译资源的路径 | `wails.json`中的值 |
| -browser | 在启动时打开浏览器到`http://localhost:34115` | |
| -compiler "compiler" | 使用不同的 go 编译器来构建，例如 go1.15beta1 | go |
| -e | 触发重新构建的扩展（逗号分隔） | go |
| -ldflags "flags" | 传递给编译器的额外 ldflags | |
| -tags "extra tags" | 构建标签以传递给编译器（引号和空格分隔） | |
| -loglevel "loglevel" | 要使用的日志级别 - Trace, Debug, Info, Warning, Error | Debug |
| -noreload | 资源更改时禁用自动重新加载 | |
| -v | 详细级别 (0 - silent, 1 - standard, 2 - verbose) | 1 |
| -wailsjsdir | 生成生成的 Wails JS 模块的目录 | `wails.json`中的值 |
| -debounce | 检测到资源更改后等待重新加载的时间 | 100 (毫秒) |
| -devserverurl "url" | 使用第 3 方开发服务器 url, 例如 Vite | "http://localhost:34115" |
如果在命令行上提供了`-assetdir`或`-wailsjsdir`标志，它们将保存在`wails.json`中，并成为后续调用的默认值。
如果在命令行上提供了`-assetdir`，`-wailsjsdir`，`debounce`或`devserverurl`标志，它们将保存在`wails.json`中，并成为后续调用的默认值。
示例：
@ -136,10 +144,12 @@ Your system is ready for Wails development!
此命令将执行以下操作：
- 构建应用程序并运行它（更多细节在[这里](/docs/guides/manual-builds)）
- 生成 Wails JS 模块 ``./frontend/src`
- 注意文件的更新`./frontend/dist`并在任何更改时重新加载
- 在`./frontend/src`中生成 Wails JS 模块
- 监听`./frontend/dist`中文件的更新并在更改时重新加载
- 打开浏览器并连接到应用程序
[此处](/docs/guides/application-development)提供了有关将此功能与现有框架脚本一起使用的更多信息。
## 生成
### 模板

10
website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/options.mdx
View file

@ -155,6 +155,14 @@ func main() {
该值是默认设置窗口的 RGBA 值。默认值：0xFFFFFFFF。
### 窗口固定在最顶层
名称：AlwaysOnTop
类型：bool
窗口在失去焦点时应保持在其他窗口之上。
### 资源
名称：Assets
@ -219,7 +227,7 @@ func main() {
定义需要绑定到前端的方法的一部分结构实例。
### 窗口
### Windows
名称：Windows

7
website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/project-config.mdx
View file

@ -11,13 +11,16 @@ sidebar_position: 5
"name": "[项目名称]",
"assetdir": "[资源目录的相对路径]",
"frontend:install": "[安装node依赖的命令，在frontend目录下运行 - 通常是 `npm install`]",
"frontend:dev": "[此命令在“Wails dev”上的单独进程中运行。适用于第三方观察者]",
"frontend:build": "[构建资源的命令，在frontend目录下运行 - 通常是 `npm run build`]",
"wailsjsdir": "[自动生成的JS模块将被创建的目录的相对路径]",
"version": "[项目配置版本]",
"outputfilename": "[二进制文件的名称]"
"outputfilename": "[二进制文件的名称]",
"debounceMS": 100, // 在检测到资源更改时，开发服务器等待重新加载的时间
"devserverurl": "[用于服务本地资源的开发服务器URL。默认：http://localhost:34115]"
}
```
该文件将在运行`wails build`或`wails dev`时，由 Wails CLI 读取。
`wails build/dev`命令中的`assetdir`和`wailsjsdir`标志将覆盖项目配置并作为后续运行的默认值。
`wails build/dev`命令中的`assetdir`,`wailsjsdir`,`debounceMS`和`devserverurl`标志将覆盖项目配置并作为后续运行的默认值。

2
website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/runtime/dialog.mdx
View file

@ -5,6 +5,8 @@ sidebar_position: 5
# 对话框
TODO: 待同步
## 概述
运行时的这一部分提供对原生对话框的调用，例如文件选择器和消息框。上下文