التثبيت

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

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

على أجهزة 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

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

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

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

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

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

تثبيت Rust

يقوم المطورون ببناء برامج Solana باستخدام لغة البرمجة 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)

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

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

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

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

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

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

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

Terminal
$
solana --version

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

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

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

Agave هو عميل validator من Anza، المعروف سابقًا باسم عميل validator من Solana Labs.

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

Terminal
$
agave-install update

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

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

يمكنك تثبيت واجهة سطر أوامر 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 CLI باستخدام AVM:

Terminal
$
avm install latest
$
avm use latest

يمكنك تثبيت إصدار محدد من Anchor CLI عن طريق تحديد رقم الإصدار:

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

Terminal
$
anchor --version

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

anchor-cli 0.31.1

عند تثبيت Anchor CLI على Linux أو WSL، قد تواجه هذا الخطأ:

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

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

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

لعرض الإعدادات الحالية:

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

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

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

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 إلى محفظة Solana الافتراضية (keypair) المستخدمة بواسطة Solana CLI لدفع رسوم المعاملات ونشر البرامج. بشكل افتراضي، يتم تخزين هذا الملف في ~/.config/solana/id.json.

إنشاء محفظة

لإرسال المعاملات باستخدام Solana CLI، تحتاج إلى محفظة Solana ممولة بعملة 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

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

Terminal
$
solana airdrop 2

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

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

Terminal
$
solana balance

تشغيل المصادق المحلي

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

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

Terminal
$
solana-test-validator

تذكر أيضًا تحديث واجهة سطر الأوامر الخاصة بك لاستخدام localhost قبل تشغيل أوامر Solana 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 تلقائيًا ببدء مصادق محلي، ونشر برنامجك، وتشغيل الاختبارات، ثم إيقاف المصادق.

Is this page helpful?