التثبيت
يغطي هذا القسم خطوات إعداد بيئتك المحلية لتطوير سولانا.
التثبيت السريع
على أنظمة 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
إذا لم يعمل أمر التثبيت السريع، يرجى الرجوع إلى قسم تثبيت التبعيات أدناه للحصول على تعليمات لتثبيت كل تبعية بشكل فردي.
إذا تم تنفيذ أمر التثبيت السريع بنجاح، انتقل إلى أقسام أساسيات واجهة سطر أوامر سولانا و أساسيات واجهة سطر أوامر Anchor أدناه.
تثبيت التبعيات
الإرشادات أدناه ترشدك خلال تثبيت كل تبعية بشكل فردي.
- يجب على مستخدمي Windows أولاً تثبيت WSL (نظام Windows الفرعي لـ Linux) ثم تثبيت التبعيات المحددة في قسم Linux أدناه.
- يجب على مستخدمي Linux أولاً تثبيت التبعيات المحددة في قسم Linux أدناه.
- يجب على مستخدمي Mac البدء بتعليمات تثبيت Rust أدناه.
تثبيت Rust
يقوم المطورون ببناء برامج سولانا باستخدام لغة البرمجة 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)
تثبيت واجهة سطر أوامر سولانا
توفر واجهة سطر أوامر سولانا جميع الأدوات المطلوبة لبناء ونشر برامج سولانا.
قم بتثبيت مجموعة أدوات واجهة سطر أوامر سولانا باستخدام أمر التثبيت الرسمي:
$sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"
يمكنك استبدال stable
بعلامة الإصدار المطابقة لإصدار البرنامج الذي ترغب فيه
(مثل v2.0.3
)، أو استخدام أحد أسماء القنوات الرمزية الثلاثة: stable
، beta
،
أو edge
.
عند تثبيت واجهة سطر أوامر سولانا للمرة الأولى، قد ترى الرسالة التالية التي تطلب
منك إضافة متغير بيئة PATH
:
أغلق وأعد فتح نافذة الطرفية الخاصة بك لتطبيق تغييرات المسار أو قم بتشغيل ما يلي في الصدفة الحالية:
export PATH="/Users/test/.local/share/solana/install/active_release/bin:$PATH"
إذا كنت تستخدم Linux أو WSL، فأنت بحاجة إلى إضافة الملف الثنائي لواجهة
سطر أوامر سولانا إلى 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 --version
يجب أن ترى مخرجات مشابهة لما يلي:
solana-cli 2.2.12 (src:0315eb6a; feat:1522022101, client:Agave)
يمكنك عرض جميع الإصدارات المتاحة على مستودع Agave على Github.
Agave هو عميل validator من Anza، والذي كان يُعرف سابقًا باسم عميل validator من سولانا لابس.
لتحديث واجهة سطر أوامر سولانا لاحقًا إلى أحدث إصدار، يمكنك استخدام الأمر التالي:
$agave-install update
تثبيت واجهة سطر أوامر Anchor
Anchor هو إطار عمل لتطوير برامج سولانا. يستخدم إطار عمل Anchor وحدات ماكرو Rust لتبسيط عملية كتابة برامج سولانا.
يمكنك تثبيت واجهة سطر أوامر 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 باستخدام AVM:
$avm install latest$avm use latest
يمكنك تثبيت إصدار محدد من واجهة سطر أوامر Anchor عن طريق تحديد رقم الإصدار:
$avm install 0.30.1$avm use 0.30.1
لا تنس تشغيل أمر avm use
لتحديد إصدار واجهة سطر أوامر Anchor الذي سيتم
تشغيله على نظامك.
- إذا قمت بتثبيت الإصدار
latest
، قم بتشغيلavm use latest
. - إذا قمت بتثبيت الإصدار
0.30.1
، قم بتشغيلavm use 0.30.1
.
للتحقق من نجاح التثبيت، تحقق من إصدار واجهة سطر أوامر Anchor:
$anchor --version
يجب أن ترى مخرجات مشابهة لما يلي:
anchor-cli 0.31.1
عند تثبيت واجهة سطر أوامر Anchor على لينكس أو WSL، قد تواجه هذا الخطأ:
error: could not exec the linker cc = note: Permission denied (os error 13)
إذا رأيت رسالة الخطأ هذه:
- قم بتثبيت التبعيات المذكورة في قسم لينكس في أعلى هذه الصفحة.
- أعد محاولة تثبيت واجهة سطر أوامر Anchor.
نود.جي إس ويارن
ملف اختبار مشروع 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)
إعداد أدوات الذكاء الاصطناعي لتطوير سولانا
يوضح هذا القسم إعداد أدوات الذكاء الاصطناعي الاختيارية التي يمكنك استخدامها لتسريع تطوير سولانا.
الأداة | الوصف | الرابط |
---|---|---|
MCP | خادم MCP الذي يمكنك الاتصال به مع cursor لتحسين تطوير سولانا بمساعدة الذكاء الاصطناعي. | https://mcp.solana.com/ |
LLMs.txt | وثائق محسنة لنماذج اللغة الكبيرة يمكنك استخدامها لتدريب LLMs على وثائق سولانا. | https://solana.com/llms.txt |
أساسيات واجهة سطر أوامر سولانا
يشرح هذا القسم بعض أوامر واجهة سطر أوامر سولانا الشائعة للبدء.
تكوين سولانا
لعرض التكوين الحالي:
$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
يحدد عنوان URL لـ RPC وعنوان URL لـ Websocket مجموعة سولانا التي ترسل إليها واجهة سطر الأوامر الطلبات.
يمكنك تحديث مجموعة واجهة سطر أوامر سولانا باستخدام الأوامر التالية:
$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 إلى محفظة سولانا الافتراضية (keypair) المستخدمة بواسطة واجهة
سطر أوامر سولانا لدفع رسوم المعاملات ونشر البرامج. بشكل افتراضي، يتم تخزين هذا
الملف في ~/.config/solana/id.json
.
إنشاء محفظة
لإرسال المعاملات باستخدام واجهة سطر أوامر سولانا، تحتاج إلى محفظة سولانا ممولة بعملة 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
ثم اطلب إسقاطًا جويًا لعملة SOL من devnet:
$solana airdrop 2
تقيد الإسقاطات الجوية في devnet الطلبات إلى 5 SOL لكل طلب. إذا واجهت حدود معدل أو أخطاء، حاول استخدام صنبور الويب بدلاً من ذلك.
للتحقق من رصيد SOL في محفظتك، قم بتشغيل الأمر التالي:
$solana balance
تشغيل الـ validator المحلي
تتضمن واجهة سطر أوامر سولانا validator اختباري مدمج للتطوير المحلي.
في نافذة طرفية منفصلة، قم بتشغيل الأمر التالي لبدء validator محلي:
$solana-test-validator
تذكر أيضًا تحديث واجهة سطر الأوامر الخاصة بك لاستخدام localhost قبل تشغيل أوامر سولانا 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 تلقائيًا ببدء
validator محلي، ونشر برنامجك، وتشغيل الاختبارات، ثم إيقاف الـ validator.
Is this page helpful?