Desarrolladores

Instalar el SDK

3 min de lecturaVer como Markdown ↗

Elige el gestor de paquetes nativo de tu lenguaje. Go, JavaScript y C/C++ usan directamente los SDK base de Go, JS/WASM y CGo. Los paquetes de los demás lenguajes envuelven esas mismas implementaciones.

Un núcleo del SDK, muchos paquetes: el módulo de Go, el runtime JS/WASM, el runtime CGo y los frameworks móviles por los que se entrega, y los paquetes de cada lenguaje que los usan o los envuelven

Disponibilidad de la versión: hoy se instalan dos paquetes desde sus registros públicos: el módulo de Go (a través del proxy de módulos de Go) y @urnetwork/sdk para JavaScript y TypeScript (npm). Los paquetes de los demás lenguajes están pendientes de publicación; sus comandos de abajo son el contrato de instalación de esa versión, y cada guía de lenguaje explica también cómo compilar los paquetes en local. Los ejemplos de sockets necesitan una versión que contenga la nueva API de sockets.

LenguajeInstalación nativaDisponible hoyGuía
Cvcpkg add port urnetwork-sdkAún no publicadoGuía de C
C++vcpkg add port urnetwork-sdkAún no publicadoGuía de C++
C#dotnet add package URnetwork.SDKAún no publicadoGuía de C#
Gogo get github.com/urnetwork/sdk/v2026@latestSíGuía de Go
Javaimplementation("io.ur:urnetwork-sdk:<version>")Aún no publicadoGuía de Java
JavaScriptnpm install @urnetwork/sdkSíGuía de JavaScript
Kotlinimplementation("io.ur:urnetwork-sdk:<version>")Aún no publicadoGuía de Kotlin
Pythonpip install urnetwork-sdkAún no publicadoGuía de Python
Rubygem install urnetwork-sdkAún no publicadoGuía de Ruby
Rustcargo add urnetwork-sdkAún no publicadoGuía de Rust
Swift.package(url: "https://github.com/urnetwork/sdk-swift", exact: "<version>")Aún no publicadoGuía de Swift
TypeScriptnpm install @urnetwork/sdkSíGuía de TypeScript

Estos comandos, sin calificar, seleccionan las versiones por defecto/estables. Para las versiones preliminares, usa npm install @urnetwork/sdk@nightly, pip install --pre urnetwork-sdk, dotnet add package URnetwork.SDK --prerelease o gem install urnetwork-sdk --pre. Cargo, Maven y SwiftPM pueden fijar la versión preliminar exacta. Los paquetes preliminares se llaman igual que los estables.

Java y Kotlin en Android

Usa io.ur:urnetwork-sdk-android:<version> en lugar de la coordenada de la JVM de escritorio. El AAR de Android se compila con gomobile; Java/Kotlin de escritorio usan JNA sobre el runtime de CGo. Swift usa el XCFramework de Apple ya existente.

Contenido de los paquetes

Los wheels de Python, las gemas de Ruby, los paquetes NuGet y los paquetes de la JVM de escritorio incluyen las bibliotecas nativas que admiten. El crate de Rust descarga en tiempo de compilación un asset nativo con la versión fijada y la suma de verificación comprobada, y lo incrusta en el ejecutable. Quien lo consume no necesita un compilador de Go ni descargar DLLs a mano. La compatibilidad se limita a las plataformas incluidas en esa versión; los paquetes de Linux declaran la versión mínima de libc que requieren.

El paquete npm contiene su runtime Go/WASM emparejado y las declaraciones de TypeScript, con ejemplos ejecutables para Node y para el navegador. Ambos usan un Device alojado ya configurado. La API fetch nativa del navegador no tiene una fábrica de sockets personalizada; consulta la guía de integración HTTP del lenguaje para ver su adaptador de peticiones de Axios y su ejemplo de Direct Sockets.

Ejemplos y comportamiento de los sockets

Abre el explorador de ejemplos para ver, en cada lenguaje, el README de instalación, la guía de ejecución socket/README.md y los archivos fuente ejecutables. Lee Sockets del SDK para conocer la diferencia entre un socket del kernel y un socket de Device, incluida la posible entrega duplicada cuando UDP pone a competir el primer datagrama entre IPv4 e IPv6.

Para la instalación desde el código fuente, la fijación de versiones y los gestores de paquetes alternativos, usa las guías de lenguaje de arriba. Las recetas de C/C++ se publican en un remote de Conan propio ya configurado o en un registro Git de vcpkg; añade ese remote/registro una vez antes de ejecutar los comandos de arriba. La inclusión en las colecciones públicas upstream requiere que sus mantenedores la acepten. Las guías de lenguaje incluyen esta configuración y la instalación local con CMake a partir de un archivo comprimido.