Desarrolladores

Instalar el SDK

2 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.

Disponibilidad de la versión: el nombre canónico @urnetwork/sdk y los nuevos paquetes de lenguaje están pendientes de publicación. Los comandos de abajo son el contrato de instalación de esa versión; 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 nativaGuía
Cvcpkg add port urnetwork-sdkGuía de C
C++vcpkg add port urnetwork-sdkGuía de C++
C#dotnet add package URnetwork.SDKGuía de C#
Gogo get github.com/urnetwork/sdk/v2026@latestGuía de Go
Javaimplementation("io.ur:urnetwork-sdk:")Guía de Java
JavaScriptnpm install @urnetwork/sdkGuía de JavaScript
Kotlinimplementation("io.ur:urnetwork-sdk:")Guía de Kotlin
Pythonpip install urnetwork-sdkGuía de Python
Rubygem install urnetwork-sdkGuía de Ruby
Rustcargo add urnetwork-sdkGuía de Rust
Swift.package(url: "https://github.com/urnetwork/sdk-swift", exact: "")Guía de Swift
TypeScriptnpm install @urnetwork/sdkGuí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: 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.