للمطوّرين

تثبيت SDK

قراءة في 3 دقائقعرض بصيغة Markdown ↗

اختر مدير الحزم الأصلي للغتك. تستخدم Go وJavaScript وC/C++‎ مباشرةً حزمَ SDK الأساسية لـGo وJS/WASM وCGo. أما حزم اللغات الأخرى فتغلّف هذه التنفيذات نفسها.

نواة SDK واحدة وحزم كثيرة: وحدة Go وبيئة تشغيل JS/WASM وبيئة تشغيل CGo وأطر عمل الجوال التي تُسلَّم عبرها، وحزم اللغات التي تستخدمها أو تغلّفها

توفّر الإصدار: تُثبَّت اليوم حزمتان من سجلّيهما العامّين: @urnetwork/sdk للغتَي JavaScript وTypeScript عبر npm، ووحدة Go عبر وكيل وحدات Go. أما حزم اللغات الأخرى فبانتظار النشر؛ وأوامرها أدناه هي عقد التثبيت لذلك الإصدار، ويشرح دليل كل لغة أيضاً بناء الحزم محلياً. وتحتاج أمثلة المقابس إلى إصدار يتضمن واجهة API الجديدة للمقابس.

اللغةالتثبيت الأصليمتاح اليومالدليل
Cvcpkg add port urnetwork-sdkلم يُنشر بعددليل C
C++‎vcpkg add port urnetwork-sdkلم يُنشر بعددليل C++‎
C#‎dotnet add package URnetwork.SDKلم يُنشر بعددليل C#‎
Gogo get github.com/urnetwork/sdk/v2026@latestنعمدليل Go
Javaimplementation("io.ur:urnetwork-sdk:<version>")لم يُنشر بعددليل Java
JavaScriptnpm install @urnetwork/sdkنعمدليل JavaScript
Kotlinimplementation("io.ur:urnetwork-sdk:<version>")لم يُنشر بعددليل Kotlin
Pythonpip install urnetwork-sdkلم يُنشر بعددليل Python
Rubygem install urnetwork-sdkلم يُنشر بعددليل Ruby
Rustcargo add urnetwork-sdkلم يُنشر بعددليل Rust
Swift.package(url: "https://github.com/urnetwork/sdk-swift", exact: "<version>")لم يُنشر بعددليل Swift
TypeScriptnpm install @urnetwork/sdkنعمدليل TypeScript

هذه الأوامر، من دون أي تحديد للإصدار، تختار الإصدارات الافتراضية/المستقرة. ولإصدارات المعاينة، استخدم npm install @urnetwork/sdk@nightly أو pip install --pre urnetwork-sdk أو dotnet add package URnetwork.SDK --prerelease أو gem install urnetwork-sdk --pre. ويستطيع Cargo وMaven وSwiftPM تثبيت إصدار المعاينة المحدد بعينه. وأسماء حزم المعاينة هي أسماء الحزم المستقرة نفسها.

Java وKotlin على Android

استخدم io.ur:urnetwork-sdk-android:<version> بدل إحداثيات حزمة JVM لسطح المكتب. فملف AAR لنظام Android مبنيّ بأداة gomobile، بينما تستخدم Java/Kotlin على سطح المكتب JNA فوق وقت تشغيل CGo. وتستخدم Swift حزمة XCFramework الموجودة أصلاً لمنصات Apple.

محتويات الحزم

تتضمن ملفات wheel لـPython، وحزم gem لـRuby، وحزم NuGet، وحزم JVM لسطح المكتب مكتباتِها الأصلية المدعومة. أما حزمة crate الخاصة بـRust فتنزّل وقتَ البناء ملفاً أصلياً مثبَّتَ الإصدار ومتحقَّقاً من مجموعه الاختباري، وتضمّنه في الملف التنفيذي. ولا يحتاج مستخدمو الحزم إلى مصرّف Go ولا إلى تنزيل DLL يدوياً. ويقتصر الدعم على المنصات المضمّنة في ذلك الإصدار؛ وتذكر حزم Linux الحدَّ الأدنى الذي تتطلبه من libc.

وتحتوي حزمة npm وقتَ تشغيل Go/WASM المقترن بها وتصريحاتِ TypeScript، مع أمثلة قابلة للتشغيل لـNode وللمتصفح. وكلاهما يستخدم جهاز Device مستضافاً مُعَدّاً. وليس لواجهة fetch الأصلية في المتصفح مصنعُ مقابس مخصص؛ فانظر دليل تكامل HTTP الخاص باللغة لتجد محوّل طلبات Axios ومثال Direct Sockets.

الأمثلة وسلوك المقابس

افتح متصفّح الأمثلة لتجد لكل لغة ملف README للتثبيت، ودليل التشغيل socket/README.md، وملفات المصدر القابلة للتنفيذ. واقرأ دليل المقابس لتعرف الفرق بين مقبس نواة النظام ومقبس Device، ومن ذلك احتمال التسليم المكرر حين يسابق UDP بأول مخطط بيانات (datagram) عبر IPv4 وIPv6.

وللتثبيت من المصدر، وتثبيت الإصدارات، ومديري الحزم البديلة، استخدم أدلة اللغات أعلاه. وتُنشر وصفات C/C++‎ في مستودع Conan بعيد (remote) أو في سجل Git لأداة vcpkg، تابعَين لنا ومُعَدَّين؛ فأضف ذلك المستودع البعيد أو السجل مرة واحدة قبل الأوامر أعلاه. أما الإدراج في المجموعات العامة الأصلية (upstream) فيتطلب قبول القائمين على صيانتها. وتتضمن أدلة اللغات هذا الإعداد، وتثبيتَ أرشيف CMake محلياً.