update faq
This commit is contained in:
@@ -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
|
||||
|
||||
@@ -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
50
docs/faq.md
vendored
@@ -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
50
docs/faq_CN.md
vendored
@@ -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.0(2025 年 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:首次构建时安装超时
|
||||
|
||||
**问题描述:**
|
||||
|
||||
Reference in New Issue
Block a user