update faq
This commit is contained in:
@@ -22,7 +22,7 @@ graph LR
|
|||||||
### Prerequisites
|
### Prerequisites
|
||||||
|
|
||||||
- Node.js ≥22.0.0 (recommended LTS, older versions ≥16.0.0 may work)
|
- 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:
|
- Platform-specific build tools:
|
||||||
- **macOS**: Xcode Command Line Tools (`xcode-select --install`)
|
- **macOS**: Xcode Command Line Tools (`xcode-select --install`)
|
||||||
- **Windows**: Visual Studio Build Tools with MSVC
|
- **Windows**: Visual Studio Build Tools with MSVC
|
||||||
|
|||||||
@@ -173,7 +173,7 @@ First-time packaging requires environment setup and may be slower, subsequent bu
|
|||||||
|
|
||||||
## Development
|
## 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
|
```bash
|
||||||
# Install dependencies
|
# 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
|
## 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
|
### Windows: Installation Timeout During First Build
|
||||||
|
|
||||||
**Problem:**
|
**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:首次构建时安装超时
|
### Windows:首次构建时安装超时
|
||||||
|
|
||||||
**问题描述:**
|
**问题描述:**
|
||||||
|
|||||||
Reference in New Issue
Block a user