docs(prerequisites): note about static libs for Alpine/musl builds#3840
Open
Metbcy wants to merge 1 commit into
Open
docs(prerequisites): note about static libs for Alpine/musl builds#3840Metbcy wants to merge 1 commit into
Metbcy wants to merge 1 commit into
Conversation
Alpine Linux uses musl, which links system libraries statically by default. Building Tauri apps there commonly fails at the linker step even after installing all the recommended -dev packages, because the corresponding *-static packages aren't installed. Document the additional apk packages that resolve the most common cases, with a heads-up that not every Tauri dependency ships as *-static on Alpine. Refs #12296 (tauri-apps/tauri)
✅ Deploy Preview for tauri-v2 ready!Built without sensitive environment variables
To edit notification comments on pull requests, go to your Netlify project configuration. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
The Alpine tab of the prerequisites page lists the
-devpackages needed to build Tauri, but Alpine targets musl, which links many system libs statically. Users following the current instructions hit linker errors for symbols from libraries thatpkg-confighappily reports as present.This adds a note + working
apk add --no-cachesnippet (openssl-libs-static,cairo-static,harfbuzz-static,glib-static,wayland-static,zlib-static) right under the existing Alpine install block, plus a heads-up that not every Tauri dep ships as*-staticon Alpine and may need to be built from source.The snippet is the working incantation
@RoDmitryposted on the upstream issue when reproducing the build failure.Refs tauri-apps/tauri#12296
Verification
src/content/docs/start/prerequisites.mdx, no code paths affected.shblock, matching the surrounding style of the existing Alpine note about fonts.