Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

first-render-document tutorial may not run on macOS after a plain cargo build

Aperta Adatta ai principianti
#1,618 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
2/5
Tempo stimato
1-3 ore
Idoneità per principianti
78/100
Tipo di issue
Documentazione
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Stack tecnologico
macos, rust

Direzione di ricerca

Inizia da docs/site/src/content/docs/tutorials/first-render-document.mdx ed esamina scripts/cargo-runtime-library-path.sh. Su macOS, verifica se target/release/registry-render viene eseguito dopo la build Cargo semplice; in caso contrario, segui l’approccio di build basato sull’helper usato dal tutorial Discovery. Il lavoro è completato quando il tutorial funziona su macOS e Linux, oppure viene registrato che registry-render non necessita dell’helper.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

area:docs area:render bug criticality:p3 triage:needs-implementation

Problem

docs/site/src/content/docs/tutorials/first-render-document.mdx tells the reader to build with a plain cargo build --release --locked -p registry-render and then run the binary directly. On macOS, a Cargo-built binary that links AWS-LC FIPS cannot run outside Cargo. The library stays in Cargo's build directory, and the binary fails with dyld: Library not loaded: @rpath/libaws_lc_fips_0_14_2_crypto.dylib. #1612 fixed the same problem on the Discovery tutorial.

Unverified: whether registry-render links AWS-LC FIPS at all. If it does not, this issue can be closed.

Proposal

Check on macOS whether target/release/registry-render runs from a shell after a plain build. If it doesn't, build the way the Discovery tutorial now does:

. scripts/cargo-runtime-library-path.sh
registry_cargo_build "$PWD" --locked --release -p registry-render

registry_cargo_build is plain cargo build on Linux and exports DYLD_FALLBACK_LIBRARY_PATH for the current shell on macOS. Every command that runs the binary must stay in that shell.

Done when

The tutorial's build step works as written on macOS and Linux, or this issue records that registry-render does not need the helper.

Lingua principale
Rust
Stelle
2
Fork
0
Merge medio
5h 13m
PR unite (30g)
176

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di registrystack/registry-stack

Tutte le issue di registrystack/registry-stack

Issue simili

Altre issue su Rust

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.