← Back to issue list

Docs: Add guide for multiarch snaps

View original Github issue

Metadata

Project
snapcraft
Number
#5041
Type
issue
State
open
Author
sed-i
Labels
—
Created
Updated
Closed
—

Current evaluation

Docs request for a multiarch guide. Questions were answered in comments and are now covered by docs/explanation/platforms.rst, reference/platforms.rst, remote-build, and a cross-compiled-app how-to.

Suggested action: close resolved

Reason: All four questions are now answered by in-repo documentation: docs/explanation/platforms.rst explains one-snap-per-arch build plans, build-on/build-for cross-compilation and Launchpad build heuristics; docs/reference/platforms.rst documents `build-for: [all]` (arch-independent snap) plus 'Supported CPU architectures' for local and Launchpad builds; docs/how-to/integrations/craft-a-cross-compiled-app.rst and docs/explanation/remote-build.rst cover cross-building and CI. This matches maintainer dilyn-corner's pointer to reference/explanation architecture pages and the reporter's 'Addressed, at least partially' reply, and the follow-up rewrite commit 88b36a7d6 ('docs: rewrite platform docs', PR #6069) resolved the duplication he flagged.

Evaluated by: mr-cal-bot

Impact: 25 Quick Win: 13 Complexity: 25 Confidence: 70 Actionability: 70

Issue body

### What needs to get done We should document how multiarch and snaps work: - Is there one *.snap file per arch (arm64, amd64, ...), or a single snap can be multiarch? - For testing purposes, can I cross-build a snap on my machine? E.g. build an arm64 snap on my amd64 machine? What if it's rust/go -- is it then possible to cross build? - What is the recommended way of setting up CI for multiarch builds? Does it have to involve launchpad? - What platforms are supported? For example, [nushell publishes](https://github.com/nushell/nushell/releases) for x86_64, riscv64gc, armv7, aarch64-pc, aarch64-apple. ### Why it needs to get done Help users understand multiarch snaps so they can produce more compelling snaps.

Evaluation history

Date Model Scores Action Summary
stealth/space-bunny-alpha
Impact: 25
Quick Win: 13
Complexity: 25
Confidence: 70
Actionability: 70
close resolved Docs request for a multiarch guide. Questions were answered in comments and are now covered by docs/explanation/platforms.rst, reference/platforms.rst, remote-build, and a cross-compiled-app how-to.
qwen/qwen3.6-35b-a3b
Impact: 30
Quick Win: 14
Complexity: 20
Confidence: 70
Actionability: 60
close resolved Documentation request for multiarch snaps guide. Questions answered in comments; reporter acknowledged partial resolution via forum post.
qwen/qwen3.8-27b
Impact: 35
Quick Win: 24
Staleness: 75
Complexity: 30
Confidence: 75
Support Request: 20
close stale Docs request for a multiarch snaps guide (one snap per arch, cross-building, CI setup, supported platforms). Reporter acknowledged partial resolution in Oct 2024; platform docs since rewritten and reorganized in the repo.
qwen/qwen3.6-35b-a3b
Staleness: 85
Complexity: 25
Confidence: 85
Support Request: 30
close stale Request to document multiarch snap workflows, including packaging, cross-compilation, and CI setup. Currently inactive for over 16 months with answers already covered in existing documentation and forum posts.
qwen3.6-35b-a3b-mtp-q6
Staleness: 90
Complexity: 25
Confidence: 80
Support Request: 20
close stale Request to document multiarch snap workflows, cross-compilation, and CI. Author notes questions are partially addressed in a forum post. Issue remains open with no maintainer labels or follow-up in over a year.

Update history

No update history recorded yet.

Related work

  • Likely Fixed By: snapcraft#6069 (confidence 78%)

    Commit 88b36a7d6 'docs: rewrite platform docs' rewrote docs/explanation/platforms.rst, the page that answers the per-arch/multiarch and cross-build questions.

  • Related To: snapcraft#6351 (confidence 60%)

    Commit 6bf11b72f 'docs: feedback from uxr' further edited docs/explanation/remote-build.rst, the CI/multi-arch remote build page referenced by this issue.

Related issues

No related issues found above the similarity threshold.