xcargo 0.1.0

Cross-compilation, zero friction - Rust cross-compilation tool with automatic toolchain management
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69

# xcargo Configuration Example
# Copy this file to xcargo.toml and customize for your project

[targets]
# Default targets to build when no target is specified
default = [
    "x86_64-unknown-linux-gnu",
    "x86_64-pc-windows-gnu",
]

# Per-target custom configuration
# [targets."x86_64-pc-windows-gnu"]
# linker = "x86_64-w64-mingw32-gcc"
# force_container = false
# rustflags = ["--cfg", "feature=\"custom\""]
#
# [targets."x86_64-pc-windows-gnu".env]
# CC = "x86_64-w64-mingw32-gcc"
# CXX = "x86_64-w64-mingw32-g++"

[build]
# Enable parallel builds for multiple targets
parallel = true

# Number of parallel jobs (omit for auto-detection)
# jobs = 4

# Enable build caching
cache = true

# Force container builds even when native is possible
force_container = false

# Additional cargo flags
cargo_flags = []

[container]
# Container runtime to use: auto, youki, docker, podman
runtime = "auto"

# When to use containers:
# - "always": Always use containers
# - "never": Never use containers
# - "target.os != host.os": Use when cross-compiling to different OS (default)
use_when = "target.os != host.os"

# Custom container image registry
# registry = "ghcr.io/xcargo"

# Image pull policy: always, never, if-not-present
pull_policy = "if-not-present"

# Example profile for CI/CD
# [profiles.ci]
# targets = [
#     "x86_64-unknown-linux-gnu",
#     "x86_64-pc-windows-gnu",
#     "x86_64-apple-darwin",
# ]

# Example profile for release builds
# [profiles.release-all]
# targets = [
#     "x86_64-unknown-linux-gnu",
#     "x86_64-pc-windows-gnu",
#     "x86_64-apple-darwin",
#     "aarch64-unknown-linux-gnu",
#     "aarch64-apple-darwin",
# ]