قم بتثبيت كل تبعية على حدة عندما تحتاج إلى إصدار محدد أو عندما لا يكتمل التثبيت السريع بنجاح. اتبع الأقسام بالترتيب لبيئة جديدة، أو انتقل مباشرةً إلى الأداة التي تحتاج إلى تثبيتها أو استكشاف أخطائها وإصلاحها.
المتطلبات الأساسية
تثبيت Rust
يقوم المطورون ببناء برامج سولانا باستخدام لغة البرمجة Rust.
- قم بتثبيت Rust باستخدام rustup عن طريق إدخال الأمر التالي في الطرفية الخاصة بك:
$curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
بعد التثبيت الناجح سترى الرسالة التالية:
- أعد تحميل متغير بيئة PATH الخاص بك لتضمين دليل bin الخاص بـ Cargo:
$. "$HOME/.cargo/env"
- تحقق من نجاح التثبيت.
$rustc --version
يطبع الأمر إصدار Rust المثبت، على سبيل المثال:
rustc x.y.z (...)
تثبيت Solana CLI
توفر Solana CLI جميع الأدوات المطلوبة لبناء ونشر برامج سولانا.
- قم بتثبيت مجموعة أدوات Solana CLI باستخدام أمر التثبيت الرسمي:
$sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"
يمكنك استبدال stable بعلامة إصدار محددة من Agave أو بقناة الإصدار beta
أو edge.
- اجعل سولانا CLI متاحًا في الطرفية الحالية.
يقوم المثبّت بتحديث إعدادات shell الخاصة بك ويطبع الأمر المطلوب لتحديث الجلسة الحالية. الأمر هو عادةً:
$export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"
إذا ظل solana غير متاح، فأعد تشغيل الطرفية. للتأكد من ملف إعدادات shell
الذي قام المثبّت بتحديثه، تحقق من shell الحالي لديك:
$echo $SHELL
- إذا كان الناتج يحتوي على
/bash، فأعد تشغيل الطرفية أو قم بتشغيلsource ~/.bashrc. - إذا كان الناتج يحتوي على
/zsh، فأعد تشغيل الطرفية أو قم بتشغيلsource ~/.zshrc.
- تحقق من نجاح التثبيت:
$solana --version
يطبع الأمر إصدار سولانا CLI المثبت، على سبيل المثال:
solana-cli x.y.z (..., client:Agave)
يمكنك عرض جميع الإصدارات المتاحة على مستودع Agave على GitHub. Agave هو عميل validator من Anza، المعروف سابقًا باسم عميل validator الخاص بـ سولانا Labs.
- لتحديث سولانا CLI لاحقًا، قم بتشغيل:
$agave-install update
تثبيت واجهة سطر أوامر Anchor
Anchor هو إطار عمل لتطوير برامج سولانا. يستفيد إطار عمل Anchor من وحدات ماكرو Rust لتبسيط عملية كتابة برامج سولانا.
المتطلبات الأساسية
لا يلزم وجود Node.js ومدير حزم JavaScript إلا عند اختيار قالب اختبار TypeScript مثل Mocha أو Jest. يعمل قالب اختبار LiteSVM الافتراضي بلغة Rust ولا يتطلب أدوات Node.js.
التثبيت
يمكنك تثبيت Anchor CLI والأدوات بطريقتين:
- Anchor Version Manager (AVM) — طريقة التثبيت الموصى بها
- بدون AVM — التثبيت مباشرة من GitHub
يتيح لك مدير إصدارات Anchor (AVM) تثبيت وإدارة إصدارات Anchor المختلفة على نظامك وتحديث إصدارات Anchor بسهولة في المستقبل. لتثبيت Anchor باستخدام AVM، اتبع الخطوات أدناه:
- قم بتثبيت AVM باستخدام الأمر التالي:
$curl -sSfL https://raw.githubusercontent.com/otter-sec/anchor/master/avm/install | sh
- تأكد من نجاح تثبيت AVM:
$avm --version
- قم بتثبيت واجهة سطر أوامر Anchor باستخدام AVM:
لتثبيت أحدث إصدار:
$avm install latest$avm use latest
لتثبيت إصدار محدد، حدد رقم الإصدار:
$avm install 1.1.2$avm use 1.1.2
عند تثبيت Anchor CLI على Linux أو WSL، قد تواجه هذا الخطأ:
error: could not exec the linker cc = note: Permission denied (os error 13)
إذا ظهرت لك رسالة الخطأ هذه، اتبع الخطوات التالية:
- ثبِّت التبعيات المدرجة في قسم Linux في أعلى هذه الصفحة.
- أعد محاولة تثبيت Anchor CLI.
- تحقق من نجاح التثبيت، من خلال التحقق من إصدار واجهة سطر أوامر Anchor:
$anchor --version
يطبع الأمر إصدار واجهة سطر أوامر Anchor النشط، على سبيل المثال:
anchor-cli 1.1.2
قم بتشغيل avm use لتحديد إصدار واجهة سطر أوامر Anchor لنظامك.
- إذا قمت بتثبيت أحدث إصدار، فقم بتشغيل
avm use latest. - إذا قمت بتثبيت الإصدار
1.1.2، فقم بتشغيلavm use 1.1.2.
تثبيت واجهة سطر أوامر Surfpool
Surfpool هي أداة للتطوير المحلي وبديل محسّن لـ
solana-test-validator.
- قم بتثبيت Surfpool باستخدام الأمر التالي:
$curl --proto '=https' --tlsv1.2 -sSfL https://run.surfpool.run/ | bash
- تحقق من نجاح التثبيت من خلال التحقق من إصدار واجهة سطر أوامر Surfpool:
$surfpool --version
يطبع الأمر إصدار واجهة سطر أوامر Surfpool المثبت، على سبيل المثال:
surfpool x.y.z
Is this page helpful?