تثبيت SDK
اختر مدير الحزم الأصلي للغتك. تستخدم Go وJavaScript وC/C++ مباشرةً حزمَ SDK الأساسية لـGo وJS/WASM وCGo. أما حزم اللغات الأخرى فتغلّف هذه التنفيذات نفسها.
توفّر الإصدار: تُثبَّت اليوم حزمتان من سجلّيهما العامّين: @urnetwork/ للغتَي JavaScript وTypeScript عبر npm، ووحدة Go عبر وكيل وحدات Go. أما حزم اللغات الأخرى فبانتظار النشر؛ وأوامرها أدناه هي عقد التثبيت لذلك الإصدار، ويشرح دليل كل لغة أيضاً بناء الحزم محلياً. وتحتاج أمثلة المقابس إلى إصدار يتضمن واجهة 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 حزمة 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/، وملفات المصدر القابلة للتنفيذ. واقرأ دليل المقابس لتعرف الفرق بين مقبس نواة النظام ومقبس Device، ومن ذلك احتمال التسليم المكرر حين يسابق UDP بأول مخطط بيانات (datagram) عبر IPv4 وIPv6.
وللتثبيت من المصدر، وتثبيت الإصدارات، ومديري الحزم البديلة، استخدم أدلة اللغات أعلاه. وتُنشر وصفات C/C++ في مستودع Conan بعيد (remote) أو في سجل Git لأداة vcpkg، تابعَين لنا ومُعَدَّين؛ فأضف ذلك المستودع البعيد أو السجل مرة واحدة قبل الأوامر أعلاه. أما الإدراج في المجموعات العامة الأصلية (upstream) فيتطلب قبول القائمين على صيانتها. وتتضمن أدلة اللغات هذا الإعداد، وتثبيتَ أرشيف CMake محلياً.