update faq

This commit is contained in:
Tw93
2025-11-16 19:56:17 +08:00
parent b4b84bd6fd
commit 5ac01d0f4a
4 changed files with 102 additions and 2 deletions

View File

@@ -22,7 +22,7 @@ graph LR
### Prerequisites
- Node.js ≥22.0.0 (recommended LTS, older versions ≥16.0.0 may work)
- Rust ≥1.89.0 (recommended stable, older versions ≥1.78.0 may work)
- Rust ≥1.85.0 (required for edition2024 support in dependencies)
- Platform-specific build tools:
- **macOS**: Xcode Command Line Tools (`xcode-select --install`)
- **Windows**: Visual Studio Build Tools with MSVC

View File

@@ -173,7 +173,7 @@ First-time packaging requires environment setup and may be slower, subsequent bu
## Development
Requires Rust `>=1.89` and Node `>=22`. For detailed installation guide, see [Tauri documentation](https://tauri.app/start/prerequisites/). If unfamiliar with development environment, use the CLI tool instead.
Requires Rust `>=1.85` and Node `>=22`. For detailed installation guide, see [Tauri documentation](https://tauri.app/start/prerequisites/). If unfamiliar with development environment, use the CLI tool instead.
```bash
# Install dependencies

50
docs/faq.md vendored
View File

@@ -6,6 +6,56 @@ Common issues and solutions when using Pake.
## Build Issues
### Rust Version Error: "feature 'edition2024' is required"
**Problem:**
When building Pake or using the CLI, you encounter an error like:
```txt
error: failed to parse manifest
Caused by:
feature `edition2024` is required
this Cargo does not support nightly features, but if you switch to nightly channel you can add `cargo-features = ["edition2024"]`
to enable this feature
```
**Why This Happens:**
Pake's dependencies require Rust edition2024 support, which is only available in Rust 1.85.0 or later. Specifically:
- The dependency chain includes: `tauri``image``moxcms``pxfm v0.1.25` (requires edition2024)
- Rust edition2024 became stable in Rust 1.85.0 (released February 2025)
- If your Rust version is older (e.g., 1.82.0 from August 2024), you'll see this error
**Solution:**
Update your Rust toolchain to version 1.85.0 or later:
```bash
# Update to the latest stable Rust version
rustup update stable
# Or install the latest stable version
rustup install stable
# Verify the update
rustc --version
# Should show: rustc 1.85.0 or higher
```
After updating, retry your build command.
**For Development Setup:**
If you're setting up a development environment, ensure:
- Rust ≥1.85.0 (check with `rustc --version`)
- Node.js ≥22.0.0 (check with `node --version`)
See [CONTRIBUTING.md](../CONTRIBUTING.md) for complete prerequisites.
---
### Windows: Installation Timeout During First Build
**Problem:**

50
docs/faq_CN.md vendored
View File

@@ -6,6 +6,56 @@
## 构建问题
### Rust 版本错误:"feature 'edition2024' is required"
**问题描述:**
在构建 Pake 或使用 CLI 时,遇到如下错误:
```txt
error: failed to parse manifest
Caused by:
feature `edition2024` is required
this Cargo does not support nightly features, but if you switch to nightly channel you can add `cargo-features = ["edition2024"]`
to enable this feature
```
**原因分析:**
Pake 的依赖项需要 Rust edition2024 支持,该特性仅在 Rust 1.85.0 或更高版本中可用。具体来说:
- 依赖链包括:`tauri``image``moxcms``pxfm v0.1.25`(需要 edition2024
- Rust edition2024 在 Rust 1.85.02025 年 2 月发布)中成为稳定版
- 如果您的 Rust 版本较旧(例如 2024 年 8 月的 1.82.0),就会看到此错误
**解决方案:**
将 Rust 工具链更新到 1.85.0 或更高版本:
```bash
# 更新到最新稳定版 Rust
rustup update stable
# 或者安装最新稳定版
rustup install stable
# 验证更新
rustc --version
# 应显示rustc 1.85.0 或更高版本
```
更新后,重新执行构建命令。
**对于开发环境设置:**
如果您正在设置开发环境,请确保:
- Rust ≥1.85.0(使用 `rustc --version` 检查)
- Node.js ≥22.0.0(使用 `node --version` 检查)
详见 [CONTRIBUTING.md](../CONTRIBUTING.md) 获取完整的前置条件。
---
### Windows首次构建时安装超时
**问题描述:**