Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

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

Abierto Apto para principiantes
#1,618 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
78/100
Tipo de issue
Documentación
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
macos, rust

Línea de trabajo

Comienza con docs/site/src/content/docs/tutorials/first-render-document.mdx e inspecciona scripts/cargo-runtime-library-path.sh. En macOS, comprueba si target/release/registry-render se ejecuta después de la compilación simple de Cargo; si no, sigue el enfoque de compilación basado en helpers que usa el tutorial de Discovery. Se considera terminado cuando el tutorial funciona en macOS y Linux, o se documenta que registry-render no necesita el helper.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

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.

Lenguaje dominante
Rust
Estrellas
2
Forks
0
Merge medio
5 h 13 min
PR fusionados (30 d)
176

Preparar el entorno

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de registrystack/registry-stack

Todos los issues de registrystack/registry-stack

Issues similares

Más issues de Rust

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.