update faq
This commit is contained in:
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:**
|
||||
|
||||
Reference in New Issue
Block a user