التثبيت

يغطي هذا القسم خطوات إعداد بيئتك المحلية لتطوير سولانا.

التثبيت السريع

على أنظمة Mac وLinux، قم بتشغيل هذا الأمر الواحد لتثبيت جميع التبعيات.

Terminal
$
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.1
Node.js: v23.11.0
Yarn: 1.22.1

إذا لم يعمل أمر التثبيت السريع، يرجى الرجوع إلى قسم تثبيت التبعيات أدناه للحصول على تعليمات لتثبيت كل تبعية بشكل فردي.

إذا تم تنفيذ أمر التثبيت السريع بنجاح، انتقل إلى أقسام أساسيات واجهة سطر أوامر سولانا و أساسيات واجهة سطر أوامر Anchor أدناه.

تثبيت التبعيات

الإرشادات أدناه ترشدك خلال تثبيت كل تبعية بشكل فردي.

  • يجب على مستخدمي Windows أولاً تثبيت WSL (نظام Windows الفرعي لـ Linux) ثم تثبيت التبعيات المحددة في قسم Linux أدناه.
  • يجب على مستخدمي Linux أولاً تثبيت التبعيات المحددة في قسم Linux أدناه.
  • يجب على مستخدمي Mac البدء بتعليمات تثبيت Rust أدناه.

تثبيت Rust

يقوم المطورون ببناء برامج سولانا باستخدام لغة البرمجة Rust.

قم بتثبيت Rust باستخدام rustup.

قم بتشغيل الأمر التالي لتثبيت Rust:

Terminal
$
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y

يجب أن ترى الرسالة التالية بعد اكتمال التثبيت:

قم بتشغيل الأمر التالي لإعادة تحميل متغير بيئة PATH الخاص بك ليشمل دليل bin الخاص بـ Cargo:

Terminal
$
. "$HOME/.cargo/env"

للتحقق من نجاح التثبيت، تحقق من إصدار Rust:

Terminal
$
rustc --version

يجب أن ترى مخرجات مشابهة لما يلي:

rustc 1.86.0 (05f9846f8 2025-03-31)

تثبيت واجهة سطر أوامر سولانا

توفر واجهة سطر أوامر سولانا جميع الأدوات المطلوبة لبناء ونشر برامج سولانا.

قم بتثبيت مجموعة أدوات واجهة سطر أوامر سولانا باستخدام أمر التثبيت الرسمي:

Terminal
$
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 الخاص بك حتى يكون الأمر متاحًا في الطرفية الخاصة بك.

أولاً، قم بتشغيل الأمر التالي للتحقق من الصدفة التي تستخدمها:

Terminal
$
echo $SHELL
  • إذا كان الناتج يحتوي على /bash، استخدم .bashrc.
  • إذا كان الناتج يحتوي على /zsh، استخدم .zshrc.

اعتمادًا على الصدفة الخاصة بك، قم بتشغيل الأمر المناسب.

لـ Bash (bashrc):

Terminal
$
echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.bashrc
$
source ~/.bashrc

لـ Zsh (zshrc):

Terminal
$
echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.zshrc
$
source ~/.zshrc

ثم قم بتشغيل الأمر التالي لتحديث جلسة الطرفية أو إعادة تشغيل الطرفية الخاصة بك.

Terminal
$
source ~/.bashrc # If using Bash
$
source ~/.zshrc # If using Zsh

للتحقق من نجاح التثبيت، تحقق من إصدار واجهة سطر أوامر سولانا:

Terminal
$
solana --version

يجب أن ترى مخرجات مشابهة لما يلي:

solana-cli 2.2.12 (src:0315eb6a; feat:1522022101, client:Agave)

يمكنك عرض جميع الإصدارات المتاحة على مستودع Agave على Github.

Agave هو عميل validator من Anza، والذي كان يُعرف سابقًا باسم عميل validator من سولانا لابس.

لتحديث واجهة سطر أوامر سولانا لاحقًا إلى أحدث إصدار، يمكنك استخدام الأمر التالي:

Terminal
$
agave-install update

تثبيت واجهة سطر أوامر Anchor

Anchor هو إطار عمل لتطوير برامج سولانا. يستخدم إطار عمل Anchor وحدات ماكرو Rust لتبسيط عملية كتابة برامج سولانا.

يمكنك تثبيت واجهة سطر أوامر Anchor والأدوات بطريقتين:

  1. مدير إصدارات Anchor (AVM) - طريقة التثبيت الموصى بها
  2. بدون AVM - التثبيت مباشرة من GitHub

يتيح لك مدير إصدارات Anchor (AVM) تثبيت وإدارة إصدارات Anchor المختلفة على نظامك وتحديث إصدارات Anchor بسهولة في المستقبل.

قم بتثبيت AVM باستخدام الأمر التالي:

Terminal
$
cargo install --git https://github.com/coral-xyz/anchor avm --force

تأكد من تثبيت AVM بنجاح:

Terminal
$
avm --version

قم بتثبيت أحدث إصدار من واجهة سطر أوامر Anchor باستخدام AVM:

Terminal
$
avm install latest
$
avm use latest

يمكنك تثبيت إصدار محدد من واجهة سطر أوامر Anchor عن طريق تحديد رقم الإصدار:

Terminal
$
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:

Terminal
$
anchor --version

يجب أن ترى مخرجات مشابهة لما يلي:

anchor-cli 0.31.1

عند تثبيت واجهة سطر أوامر Anchor على لينكس أو WSL، قد تواجه هذا الخطأ:

error: could not exec the linker cc = note: Permission denied (os error 13)

إذا رأيت رسالة الخطأ هذه:

  1. قم بتثبيت التبعيات المذكورة في قسم لينكس في أعلى هذه الصفحة.
  2. أعد محاولة تثبيت واجهة سطر أوامر 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

أساسيات واجهة سطر أوامر سولانا

يشرح هذا القسم بعض أوامر واجهة سطر أوامر سولانا الشائعة للبدء.

تكوين سولانا

لعرض التكوين الحالي:

Terminal
$
solana config get

يجب أن ترى مخرجات مشابهة لما يلي:

Config File: /Users/test/.config/solana/cli/config.yml
RPC URL: https://api.mainnet-beta.solana.com
WebSocket URL: wss://api.mainnet-beta.solana.com/ (computed)
Keypair Path: /Users/test/.config/solana/id.json
Commitment: confirmed

يحدد عنوان URL لـ RPC وعنوان URL لـ Websocket مجموعة سولانا التي ترسل إليها واجهة سطر الأوامر الطلبات.

يمكنك تحديث مجموعة واجهة سطر أوامر سولانا باستخدام الأوامر التالية:

Terminal
$
solana config set --url mainnet-beta
$
solana config set --url devnet
$
solana config set --url localhost
$
solana config set --url testnet

يمكنك أيضًا استخدام الخيارات المختصرة التالية:

Terminal
$
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 في مسار المحفظة الافتراضي، قم بتشغيل الأمر التالي:

Terminal
$
solana-keygen new

يجب أن ترى مخرجات مشابهة لما يلي:

Generating a new keypair
For added security, enter a BIP39 passphrase
NOTE! This passphrase improves security of the recovery seed phrase NOT the
keypair file itself, which is stored as insecure plain text
BIP39 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.

لعرض عنوان محفظتك (المفتاح العام)، قم بتشغيل:

Terminal
$
solana address

الحصول على SOL من خلال الإسقاط الجوي

اطلب إسقاطًا جويًا لعملة SOL إلى محفظتك لدفع تكاليف المعاملات ونشر البرامج.

قم بتعيين مجموعتك إلى شبكة devnet:

Terminal
$
solana config set -ud

ثم اطلب إسقاطًا جويًا لعملة SOL من devnet:

Terminal
$
solana airdrop 2

تقيد الإسقاطات الجوية في devnet الطلبات إلى 5 SOL لكل طلب. إذا واجهت حدود معدل أو أخطاء، حاول استخدام صنبور الويب بدلاً من ذلك.

للتحقق من رصيد SOL في محفظتك، قم بتشغيل الأمر التالي:

Terminal
$
solana balance

تشغيل الـ validator المحلي

تتضمن واجهة سطر أوامر سولانا validator اختباري مدمج للتطوير المحلي.

في نافذة طرفية منفصلة، قم بتشغيل الأمر التالي لبدء validator محلي:

Terminal
$
solana-test-validator

تذكر أيضًا تحديث واجهة سطر الأوامر الخاصة بك لاستخدام localhost قبل تشغيل أوامر سولانا CLI:

Terminal
$
solana config set -ul

أساسيات واجهة سطر أوامر Anchor

يستعرض هذا القسم بعض أوامر واجهة سطر أوامر Anchor الشائعة لمساعدتك في البدء. لمزيد من المعلومات حول واجهة سطر أوامر Anchor، راجع وثائق Anchor.

تهيئة المشروع

لإنشاء مشروع Anchor جديد، قم بتشغيل الأمر التالي:

Terminal
$
anchor init <project-name>

على سبيل المثال، لإنشاء مشروع يسمى my-project، قم بتشغيل:

Terminal
$
anchor init my-project

ينشئ هذا الأمر دليلًا جديدًا باسم المشروع ويقوم بتهيئة مشروع Anchor جديد مع برنامج Rust أساسي وقالب اختبار TypeScript.

انتقل إلى دليل المشروع:

Terminal
$
cd <project-name>

اطلع على هيكل ملفات مشروع Anchor.

بناء البرنامج

لبناء مشروعك، قم بتشغيل الأمر التالي:

Terminal
$
anchor build

يمكنك العثور على البرنامج المُجمّع في دليل /target/deploy.

نشر البرنامج

لنشر مشروعك، قم بتشغيل الأمر التالي:

Terminal
$
anchor deploy

يقوم هذا الأمر بنشر برنامجك على cluster المحدد في ملف Anchor.toml.

اختبار البرنامج

لاختبار مشروعك، قم بتشغيل الأمر التالي:

Terminal
$
anchor test

يقوم هذا الأمر ببناء ونشر وتشغيل الاختبارات لمشروعك.

عند استخدام localnet كـ cluster في Anchor.toml، يقوم Anchor تلقائيًا ببدء validator محلي، ونشر برنامجك، وتشغيل الاختبارات، ثم إيقاف الـ validator.

Is this page helpful?