diff --git a/readme_i18n/README_ZH.md b/readme_i18n/README_ZH.md index 59847baf..c97998a2 100644 --- a/readme_i18n/README_ZH.md +++ b/readme_i18n/README_ZH.md @@ -21,7 +21,6 @@ LocalSend 是一个自由、开源的应用程序，允许你在本地网络上 - [关于](#关于) - [截图](#截图) - [下载](#下载) -- [设置](#设置) - [工作原理](#工作原理) - [开始使用](#开始使用) - [贡献](#贡献) @@ -33,7 +32,6 @@ LocalSend 是一个自由、开源的应用程序，允许你在本地网络上 - [macOS](#macos) - [Windows](#windows) - [Linux](#linux) -- [贡献者](#贡献者) ## 关于 @@ -50,11 +48,12 @@ LocalSend 是一个跨平台应用程序，使用 REST API 和 HTTPS 加密实 | Windows | macOS | Linux | Android | iOS | Fire OS | |--------------------------|-------------------------|--------------------|----------------|---------------|------------| | [Winget][] | [App Store][] | [Flathub][] | [Play Store][] | [App Store][] | [Amazon][] | -| [Scoop][] | [Homebrew][] | [AUR][] | [F-Droid][] | | | -| [Chocolatey][] | [DMG Installer][latest] | [Nixpkgs][] | [APK][latest] | | | -| [MSIX Installer][latest] | | [TAR][latest] | | | | -| [EXE Installer][latest] | | [DEB][latest] | | | | -| [Portable ZIP][latest] | | [AppImage][latest] | | | | +| [Scoop][] | [Homebrew][] | [Nixpkgs][] | [F-Droid][] | | | +| [Chocolatey][] | [DMG Installer][latest] | [Snap][] | [APK][latest] | | | +| [EXE Installer][latest] | | [AUR][] | | | | +| [Portable ZIP][latest] | | [TAR][latest] | | | | +| | | [DEB][latest] | | | | +| | | [AppImage][latest] | | | | 了解更多关于[发行渠道][]的信息。 @@ -69,21 +68,32 @@ LocalSend 是一个跨平台应用程序，使用 REST API 和 HTTPS 加密实 [chocolatey]: https://community.chocolatey.org/packages/localsend [homebrew]: https://formulae.brew.sh/cask/localsend [flathub]: https://flathub.org/apps/details/org.localsend.localsend_app -[aur]: https://aur.archlinux.org/packages/localsend-bin [nixpkgs]: https://search.nixos.org/packages?show=localsend +[snap]: https://snapcraft.io/localsend +[aur]: https://aur.archlinux.org/packages/localsend-bin [latest]: https://github.com/localsend/localsend/releases/latest [发行渠道]: https://github.com/localsend/localsend/blob/main/CONTRIBUTING.md#distribution +**兼容性** +| 平台 | 最低版本 | 备注 | +|---------|------------|--------------------------------------------------------------------------------------------------------------------------------| +|Android | 5.0 | - | +|iOS | 12.0 | - | +|macOS | 11 Big Sur | 请使用 OpenCore Legacy Patcher 2.0.2 （见 [#1005](https://github.com/localsend/localsend/issues/1005#issuecomment-2449899384)） | +|Windows | 10 | 最后一个支持 Windows 7 的版本是 v1.15.4 。未来也许会将更新的版本向后移植至兼容 Windows 7 。 | +|Linux | 不适用 | - | + ## 设置 在大多数情况下，LocalSend 应该可以直接使用。但是，如果你在发送或接收文件时遇到问题，可能需要配置防火墙以允许 LocalSend 在你的本地网络上通信。 -| 流量类型 | 协议 | 端口 | 操作 | -|---------|------|------|------| -| 传入 | TCP, UDP | 53317 | 允许 | -| 传出 | TCP, UDP | 任意 | 允许 | +| 流量类型 | 协议 | 端口 | 操作 | +|----------|----------|-------|------| +| 传入 | TCP, UDP | 53317 | 允许 | +| 传出 | TCP, UDP | 任意 | 允许 | 另外，请确保禁用路由器上的 AP 隔离。通常默认情况下应禁用它，但某些路由器可能会启用它（比如访客网络）。 +更多信息见 [故障排查](#故障排查)。 **便携模式** @@ -93,6 +103,14 @@ LocalSend 是一个跨平台应用程序，使用 REST API 和 HTTPS 加密实 此文件可以为空。 应用程序将使用此文件来存储设置，而不是默认位置。 +**隐藏式启动** + +（更新于 v1.15.0） + +使用 `--hidden` 命令行参数隐藏式启动（只在系统托盘里显示）此应用（例如： `localsend_app.exe --hidden`）。 + +在 v1.14.0 或更早的版本中，如果设置了 `autostart` 标志，并且启用了隐藏设置，则应用程序将会隐藏式启动。 + ## 工作原理 LocalSend 使用安全通信协议，允许设备通过 REST API 进行通信。所有数据都通过 HTTPS 安全地发送，并且 TLS/SSL 证书会在每台设备上动态生成，确保最大的安全性。 @@ -105,14 +123,16 @@ LocalSend 使用安全通信协议，允许设备通过 REST API 进行通信。 1. 安装 [Flutter](https://flutter.dev)。 2. 安装 [Rust](https://www.rust-lang.org/tools/install)。 -3. 克隆 LocalSend 代码库。 +3. 克隆 `LocalSend` 代码库。 4. 执行 `cd app` 进入 app 目录。 5. 运行 `flutter pub get` 下载依赖项。 6. 运行 `flutter run` 启动应用程序。 -可能的问题是所需的 Flutter 版本与已安装的 Flutter 版本不匹配。 - -LocalSend 使用 [fvm](https://fvm.app) 管理项目的 Flutter 版本（在 [.fvm/fvm_config.json](.fvm/fvm_config.json) 中指定）。安装后，运行 `fvm flutter` 而不是 `flutter`。 +> [!NOTE] +> LocalSend 目前需要老版本的 Flutter （具体见 [.fvmrc](/.fvmrc)） +> 因而一些构建问题也许是系统安装的 Flutter 版本和 LocalSend 所需的 Flutter 版本不一致导致的。 +> 为了在开发过程中保持一致性，LocalSend 使用 [fvm](https://fvm.app) 来管理此项目的 Flutter 版本。 +> 安装 `fvm` 后，请运行 `fvm flutter` 而非 `flutter` 。 ## 贡献 @@ -120,22 +140,15 @@ LocalSend 使用 [fvm](https://fvm.app) 管理项目的 Flutter 版本（在 [.f ### 翻译 -你可以帮助将此应用程序翻译成其他语言！ +你可以帮助将此应用程序翻译成其他语言。我们使用 [Weblate](https://hosted.weblate.org/projects/localsend/app) 平台来管理翻译。 -1. Fork 此代码库 -2. 选择一种方式 - - 在现有语言中添加缺失的翻译：只需更新 [app/assets/i18n][i18n] 中的 `_missing_translations_.json` - - 修复现有的翻译：更新 [app/assets/i18n][i18n] 中的 `strings_.i18n.json` - - 添加新的语言：创建一个新文件；参见：[语言代码][locale codes]。 -3. 可选步骤：重新运行此应用程序 - 1. 执行 `cd app` 进入 app 目录。 - 2. 确保你已经 [运行](#开始使用) 过此应用程序一次。 - 3. 通过 `flutter pub run slang` 更新翻译 - 4. 通过 `flutter run` 运行应用程序 - 5. 提交拉取请求 +另外，你也可以 fork 这个仓库并手动添加翻译。 -[i18n]: https://github.com/localsend/localsend/tree/main/app/assets/i18n -[locale codes]: https://saimana.com/list-of-country-locale-code/ +翻译在 [app/assets/i18n](https://github.com/localsend/localsend/tree/main/app/assets/i18n) 目录。编辑 `_missing_translations_.json` 或 `strings_.i18n.json` 文件来添加或更新翻译。 + + +Translation status + **_注意：_ 用 `@` 装饰的字段不是用于翻译的；它们在应用程序中没有任何用处，仅仅是关于文件的信息性文本或为翻译者提供上下文。** @@ -146,6 +159,16 @@ LocalSend 使用 [fvm](https://fvm.app) 管理项目的 Flutter 版本（在 [.f 欲了解更多信息，请参阅[贡献指南](https://github.com/localsend/localsend/blob/main/CONTRIBUTING.md)。 +## 故障排查 + +| 问题 | 平台（发送端） | 平台（接收端） | 解决办法 +|------------|---------------|-----------------|----------------------------------------------------------------------------| +| 设备不可见 | 任何 | 任何 | 确保关闭路由器的AP隔离。如果AP隔离是开着的，设备间的连接会被禁止。 | +| 设备不可见 | 任何 | Windows | 确保将你的网络配置为“私有”网络。当你的网络为公共网络时 Windows 会更具限制性。 | +| 设备不可见 | macOS, iOS | 任何 | 尝试在系统设置中的“隐私”下切换“本地网络”权限。 | +| 速度太慢 | 任何 | 任何 | 使用 5 Ghz 频段；关闭发送和接收端设备的数据加密。 | +| 速度太慢 | 任何 | 安卓 | 已知的问题。见 https://github.com/flutter-cavalry/saf_stream/issues/4 | + ## 构建 这些命令仅供维护者使用。 @@ -212,7 +235,7 @@ appimage-builder --recipe AppImageBuilder.yml **Snap** -欢迎提交拉取请求！仓库有一个 `snap` 分支可以尝试使用。 +使用说明：[localsend/snap/README.md](https://github.com/localsend/snap/blob/main/README.md) ## 贡献者