التثبيت
يغطي هذا القسم خطوات إعداد بيئتك المحلية لتطوير Solana.
التثبيت السريع
على أجهزة Mac وLinux، قم بتشغيل هذا الأمر الواحد لتثبيت جميع التبعيات.
$curl --proto '=https' --tlsv1.2 -sSfL https://solana-install.solana.workers.dev | bash
مستخدمو Windows: يجب عليك أولاً تثبيت WSL (انظر تثبيت التبعيات). ثم قم بتشغيل الأمر السابق في طرفية Ubuntu (Linux).
بعد التثبيت، يجب أن ترى مخرجات مثل ما يلي:
Installed Versions:Rust: rustc 1.86.0 (05f9846f8 2025-03-31)Solana CLI: solana-cli 2.2.12 (src:0315eb6a; feat:1522022101, client:Agave)Anchor CLI: anchor-cli 0.31.1Node.js: v23.11.0Yarn: 1.22.1
إذا لم يعمل أمر التثبيت السريع، يرجى الرجوع إلى قسم تثبيت التبعيات أدناه للحصول على تعليمات لتثبيت كل تبعية بشكل فردي.
إذا تم تشغيل أمر التثبيت السريع بنجاح، انتقل إلى أقسام أساسيات واجهة سطر أوامر Solana و أساسيات واجهة سطر أوامر Anchor أدناه.
تثبيت التبعيات
ترشدك التعليمات أدناه خلال تثبيت كل تبعية بشكل فردي.
- يجب على مستخدمي Windows أولاً تثبيت WSL (نظام Windows الفرعي لـ Linux) ثم تثبيت التبعيات المحددة في قسم Linux أدناه.
- يجب على مستخدمي Linux أولاً تثبيت التبعيات المحددة في قسم Linux أدناه.
- يجب على مستخدمي Mac البدء بتعليمات تثبيت Rust أدناه.
تثبيت Rust
يقوم المطورون ببناء برامج Solana باستخدام لغة البرمجة Rust.
قم بتثبيت Rust باستخدام rustup.
قم بتشغيل الأمر التالي لتثبيت Rust:
$curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
يجب أن ترى الرسالة التالية بعد اكتمال التثبيت:
قم بتشغيل الأمر التالي لإعادة تحميل متغير بيئة PATH الخاص بك ليشمل دليل bin الخاص بـ Cargo:
$. "$HOME/.cargo/env"
للتحقق من نجاح التثبيت، تحقق من إصدار Rust:
$rustc --version
يجب أن ترى مخرجات مثل ما يلي:
rustc 1.86.0 (05f9846f8 2025-03-31)
تثبيت واجهة سطر أوامر Solana
توفر واجهة سطر أوامر Solana جميع الأدوات المطلوبة لبناء ونشر برامج Solana.
قم بتثبيت مجموعة أدوات واجهة سطر أوامر Solana باستخدام أمر التثبيت الرسمي:
$sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"
يمكنك استبدال stable
بعلامة الإصدار المطابقة لإصدار البرنامج الذي ترغب فيه
(مثل v2.0.3
)، أو استخدام أحد أسماء القنوات الرمزية الثلاثة: stable
، أو
beta
، أو edge
.
عند تثبيت واجهة سطر أوامر Solana للمرة الأولى، قد ترى الرسالة التالية التي تطلب
منك إضافة متغير بيئة PATH
:
Close and reopen your terminal to apply the PATH changes or run the following in your existing shell:export PATH="/Users/test/.local/share/solana/install/active_release/bin:$PATH"
إذا كنت تستخدم Linux أو WSL، فأنت بحاجة إلى إضافة الملف الثنائي لواجهة
سطر أوامر Solana إلى PATH
حتى يكون الأمر متاحًا في الطرفية الخاصة بك.
أولاً، قم بتشغيل الأمر التالي للتحقق من الشل الذي تستخدمه:
$echo $SHELL
- إذا كانت المخرجات تحتوي على
/bash
، استخدم.bashrc
. - إذا كانت المخرجات تحتوي على
/zsh
، استخدم.zshrc
.
اعتمادًا على الشل الخاص بك، قم بتشغيل الأمر المناسب.
لـ Bash (bashrc
):
$echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.bashrc$source ~/.bashrc
لـ Zsh (zshrc
):
$echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.zshrc$source ~/.zshrc
ثم قم بتشغيل الأمر التالي لتحديث جلسة الطرفية أو إعادة تشغيل الطرفية.
$source ~/.bashrc # If using Bash$source ~/.zshrc # If using Zsh
للتحقق من نجاح التثبيت، تحقق من إصدار واجهة سطر أوامر Solana:
$solana --version
يجب أن ترى مخرجات مشابهة لما يلي:
solana-cli 2.2.12 (src:0315eb6a; feat:1522022101, client:Agave)
يمكنك عرض جميع الإصدارات المتاحة على مستودع Agave على Github.
Agave هو عميل validator من Anza، المعروف سابقًا باسم عميل validator من Solana Labs.
لتحديث واجهة سطر أوامر Solana لاحقًا إلى أحدث إصدار، يمكنك استخدام الأمر التالي:
$agave-install update
تثبيت واجهة سطر أوامر Anchor
Anchor هو إطار عمل لتطوير برامج Solana. يستفيد إطار عمل Anchor من وحدات ماكرو Rust لتبسيط عملية كتابة برامج Solana.
يمكنك تثبيت واجهة سطر أوامر Anchor والأدوات بطريقتين:
- مدير إصدارات Anchor (AVM) - طريقة التثبيت الموصى بها
- بدون AVM - التثبيت مباشرة من GitHub
يتيح لك مدير إصدارات Anchor (AVM) تثبيت وإدارة إصدارات Anchor المختلفة على نظامك وتحديث إصدارات Anchor بسهولة في المستقبل.
قم بتثبيت AVM باستخدام الأمر التالي:
$cargo install --git https://github.com/coral-xyz/anchor avm --force
تأكد من تثبيت AVM بنجاح:
$avm --version
قم بتثبيت أحدث إصدار من Anchor CLI باستخدام AVM:
$avm install latest$avm use latest
يمكنك تثبيت إصدار محدد من Anchor CLI عن طريق تحديد رقم الإصدار:
$avm install 0.30.1$avm use 0.30.1
لا تنس تشغيل أمر avm use
لتحديد إصدار Anchor CLI الذي سيتم تشغيله على
نظامك.
- إذا قمت بتثبيت الإصدار
latest
، قم بتشغيلavm use latest
. - إذا قمت بتثبيت الإصدار
0.30.1
، قم بتشغيلavm use 0.30.1
.
للتحقق من نجاح التثبيت، تحقق من إصدار Anchor CLI:
$anchor --version
يجب أن ترى مخرجات مشابهة لما يلي:
anchor-cli 0.31.1
عند تثبيت Anchor CLI على Linux أو WSL، قد تواجه هذا الخطأ:
error: could not exec the linker cc = note: Permission denied (os error 13)
إذا رأيت رسالة الخطأ هذه:
- قم بتثبيت التبعيات المذكورة في قسم Linux في أعلى هذه الصفحة.
- أعد محاولة تثبيت Anchor CLI.
Node.js و Yarn
ملف اختبار مشروع Anchor الافتراضي (TypeScript) الذي تم إنشاؤه باستخدام الأمر
anchor init
يتطلب Node.js و Yarn. (قالب اختبار Rust متاح باستخدام
anchor init --test-template rust
)
عند تشغيل anchor build
، إذا واجهت الأخطاء التالية:
بعد تطبيق الحل السابق، حاول تشغيل anchor build
مرة أخرى.
عند تشغيل anchor test
بعد إنشاء مشروع Anchor جديد على Linux أو WSL، قد
تواجه الأخطاء التالية إذا لم يكن لديك Node.js أو Yarn مثبتين:
Permission denied (os error 13)
No such file or directory (os error 2)
أساسيات واجهة سطر أوامر Solana
يستعرض هذا القسم بعض أوامر واجهة سطر أوامر Solana الشائعة لمساعدتك في البدء.
إعدادات Solana
لعرض الإعدادات الحالية:
$solana config get
يجب أن ترى مخرجات مشابهة لما يلي:
Config File: /Users/test/.config/solana/cli/config.ymlRPC URL: https://api.mainnet-beta.solana.comWebSocket URL: wss://api.mainnet-beta.solana.com/ (computed)Keypair Path: /Users/test/.config/solana/id.jsonCommitment: confirmed
يحدد عنوان RPC وعنوان Websocket مجموعة Solana التي يرسل إليها واجهة سطر الأوامر الطلبات.
يمكنك تحديث مجموعة Solana CLI باستخدام الأوامر التالية:
$solana config set --url mainnet-beta$solana config set --url devnet$solana config set --url localhost$solana config set --url testnet
يمكنك أيضًا استخدام الخيارات المختصرة التالية:
$solana config set -um # For mainnet-beta$solana config set -ud # For devnet$solana config set -ul # For localhost$solana config set -ut # For testnet
يشير مسار keypair إلى محفظة Solana الافتراضية (keypair) المستخدمة بواسطة Solana
CLI لدفع رسوم المعاملات ونشر البرامج. بشكل افتراضي، يتم تخزين هذا الملف في
~/.config/solana/id.json
.
إنشاء محفظة
لإرسال المعاملات باستخدام Solana CLI، تحتاج إلى محفظة Solana ممولة بعملة SOL.
لإنشاء keypair في مسار المفاتيح الافتراضي، قم بتشغيل الأمر التالي:
$solana-keygen new
يجب أن ترى مخرجات مشابهة لما يلي:
Generating a new keypairFor added security, enter a BIP39 passphraseNOTE! This passphrase improves security of the recovery seed phrase NOT thekeypair file itself, which is stored as insecure plain textBIP39 Passphrase (empty for none):Wrote new keypair to /Users/test/.config/solana/id.json===========================================================================pubkey: 8dBTPrjnkXyuQK3KDt9wrZBfizEZijmmUQXVHpFbVwGT===========================================================================Save this seed phrase and your BIP39 passphrase to recover your new keypair:cream bleak tortoise ocean nasty game gift forget fancy salon mimic amazing===========================================================================
إذا كان لديك بالفعل محفظة نظام ملفات محفوظة في الموقع الافتراضي، فإن هذا الأمر
لا يقوم بتجاوزها إلا إذا قمت بفرض التجاوز صراحةً باستخدام علامة --force
.
لعرض عنوان محفظتك (المفتاح العام)، قم بتشغيل:
$solana address
الحصول على SOL عبر الإسقاط الجوي
اطلب إسقاطًا جويًا لعملة SOL إلى محفظتك لدفع تكاليف المعاملات ونشر البرامج.
اضبط العنقود الخاص بك على devnet:
$solana config set -ud
ثم اطلب إسقاطًا جويًا من devnet SOL:
$solana airdrop 2
الإسقاطات الجوية على devnet تحد الطلبات إلى 5 SOL لكل طلب. إذا وصلت إلى حدود المعدل أو واجهت أخطاء، حاول استخدام صنبور الويب بدلاً من ذلك.
للتحقق من رصيد SOL في محفظتك، قم بتشغيل الأمر التالي:
$solana balance
تشغيل المصادق المحلي
تتضمن واجهة سطر أوامر Solana مصادق اختبار مدمج للتطوير المحلي.
في نافذة طرفية منفصلة، قم بتشغيل الأمر التالي لبدء مصادق محلي:
$solana-test-validator
تذكر أيضًا تحديث واجهة سطر الأوامر الخاصة بك لاستخدام localhost قبل تشغيل أوامر Solana CLI:
$solana config set -ul
أساسيات واجهة سطر أوامر Anchor
يستعرض هذا القسم بعض أوامر واجهة سطر أوامر Anchor الشائعة لمساعدتك على البدء. لمزيد من المعلومات حول واجهة سطر أوامر Anchor، راجع وثائق Anchor.
تهيئة المشروع
لإنشاء مشروع Anchor جديد، قم بتشغيل الأمر التالي:
$anchor init <project-name>
على سبيل المثال، لإنشاء مشروع يسمى my-project
، قم بتشغيل:
$anchor init my-project
يقوم هذا الأمر بإنشاء دليل جديد باسم المشروع وتهيئة مشروع Anchor جديد مع برنامج Rust أساسي وقالب اختبار TypeScript.
انتقل إلى دليل المشروع:
$cd <project-name>
اطلع على هيكل ملفات مشروع Anchor.
بناء البرنامج
لبناء مشروعك، قم بتشغيل الأمر التالي:
$anchor build
يمكنك العثور على البرنامج المُجمّع في دليل /target/deploy
.
نشر البرنامج
لنشر مشروعك، قم بتشغيل الأمر التالي:
$anchor deploy
يقوم هذا الأمر بنشر برنامجك على cluster
المحدد في ملف
Anchor.toml
.
اختبار البرنامج
لاختبار مشروعك، قم بتشغيل الأمر التالي:
$anchor test
يقوم هذا الأمر ببناء ونشر وتشغيل الاختبارات لمشروعك.
عند استخدام localnet
كـ cluster
في Anchor.toml
، يقوم Anchor تلقائيًا ببدء
مصادق محلي، ونشر برنامجك، وتشغيل الاختبارات، ثم إيقاف المصادق.
Is this page helpful?