Установка SDK
Выберите нативный менеджер пакетов своего языка. Go, JavaScript и C/C++ напрямую используют базовые SDK: Go, JS/WASM и CGo. Пакеты для остальных языков оборачивают те же самые реализации.
Доступность релиза: сегодня из публичных реестров устанавливаются два пакета: модуль Go (через прокси модулей Go) и @urnetwork/ для JavaScript и TypeScript (npm). Пакеты для остальных языков ожидают публикации; их команды ниже — контракт установки для этого релиза, а руководство по каждому языку также объясняет локальную сборку пакетов. Примерам с сокетами нужен релиз, содержащий новый API сокетов.
| Язык | Нативная установка | Доступно сейчас | Руководство |
|---|---|---|---|
| C | vcpkg add port urnetwork-sdk | Ещё не опубликован | Руководство по C |
| C++ | vcpkg add port urnetwork-sdk | Ещё не опубликован | Руководство по C++ |
| C# | dotnet add package URnetwork.SDK | Ещё не опубликован | Руководство по C# |
| Go | go get github.com/ | Да | Руководство по Go |
| Java | implementation("io.ur: | Ещё не опубликован | Руководство по Java |
| JavaScript | npm install @urnetwork/ | Да | Руководство по JavaScript |
| Kotlin | implementation("io.ur: | Ещё не опубликован | Руководство по Kotlin |
| Python | pip install urnetwork-sdk | Ещё не опубликован | Руководство по Python |
| Ruby | gem install urnetwork-sdk | Ещё не опубликован | Руководство по Ruby |
| Rust | cargo add urnetwork-sdk | Ещё не опубликован | Руководство по Rust |
| Swift | .package(url: "https:// | Ещё не опубликован | Руководство по Swift |
| TypeScript | npm install @urnetwork/ | Да | Руководство по TypeScript |
Эти команды без уточнений выбирают релизы по умолчанию/стабильные. Для предварительных версий используйте npm install @urnetwork/, pip install --pre urnetwork-sdk, dotnet add package URnetwork.SDK --prerelease или gem install urnetwork-sdk --pre. Cargo, Maven и SwiftPM позволяют закрепить точную предварительную версию. Имена пакетов предварительных версий совпадают с именами стабильных пакетов.
Java и Kotlin на Android
Используйте io.ur: вместо координат для десктопной JVM. AAR для Android собирается с помощью gomobile; десктопные Java/Kotlin используют JNA поверх рантайма CGo. Swift использует существующий Apple XCFramework.
Содержимое пакетов
Wheel-пакеты Python, гемы Ruby, пакеты NuGet и десктопные JVM-пакеты включают свои поддерживаемые нативные библиотеки. Крейт Rust во время сборки скачивает нативный ассет с закреплённой версией и проверенной контрольной суммой и встраивает его в исполняемый файл. Потребителям не нужны ни компилятор Go, ни ручное скачивание DLL. Поддержка ограничена платформами, включёнными в этот релиз; пакеты для Linux указывают свою минимальную версию libc.
npm-пакет содержит парный ему рантайм Go/WASM и объявления TypeScript, а также запускаемые примеры для Node и браузера. И те и другие используют настроенный размещённый Device. У нативного fetch API браузера нет пользовательской фабрики сокетов; адаптер запросов Axios и пример с Direct Sockets ищите в руководстве по HTTP-интеграции для этого языка.
Примеры и поведение сокетов
Откройте обозреватель примеров: для каждого языка там есть README по установке, руководство по запуску socket/ и исполняемые исходные файлы. О разнице между сокетом ядра и сокетом Device, включая возможную доставку дубликатов, когда UDP устраивает гонку первой датаграммы между IPv4 и IPv6, читайте в руководстве по сокетам.
Об установке из исходников, закреплении версий и альтернативных менеджерах пакетов читайте в руководствах по языкам выше. Рецепты C/C++ публикуются в настроенный собственный удалённый репозиторий Conan или Git-реестр vcpkg; добавьте этот репозиторий/реестр один раз, прежде чем выполнять команды выше. Попадание в публичные коллекции апстрима требует одобрения их мейнтейнеров. Руководства по языкам описывают эту настройку и локальную установку из архива CMake.