وثائق سولاناالبدءالتثبيت

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

دليل لإعداد بيئة تطوير سولانا المحلية الخاصة بك. تعلم كيفية تثبيت Rust وواجهة سطر أوامر سولانا وإطار عمل Anchor على نظام ويندوز (WSL) ولينكس وماك. استخدم هذا الدليل إذا كنت تفضل تثبيت كل تبعية بشكل فردي، أو إذا فشل التثبيت السريع لأي سبب.

المتطلبات الأساسية

تثبيت Rust

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

  1. قم بتثبيت Rust باستخدام rustup عن طريق إدخال الأمر التالي في نافذة الطرفية الخاصة بك:
Terminal
$ 
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y

بعد التثبيت الناجح ستظهر لك الرسالة التالية:

  1. أعد تحميل متغير بيئة PATH الخاص بك ليشمل دليل bin الخاص بـ Cargo:
Terminal
$ 
. "$HOME/.cargo/env"
  1. تحقق من نجاح عملية التثبيت.
Terminal
$ 
rustc --version

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

rustc 1.86.0 (05f9846f8 2025-03-31)

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

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

  1. قم بتثبيت مجموعة أدوات واجهة سطر أوامر سولانا باستخدام أمر التثبيت الرسمي:
Terminal
$ 
sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"

يمكنك استبدال stable بعلامة الإصدار المطابقة لإصدار البرنامج الذي ترغب فيه (مثل v2.0.3)، أو استخدام أحد أسماء القنوات الرمزية الثلاثة: stable، beta، أو edge.

  1. إضافة متغير بيئة PATH

قد يطالبك التثبيت الأول لواجهة سطر أوامر سولانا بإضافة متغير بيئة PATH. للقيام بذلك، أغلق وأعد فتح نافذة الطرفية أو قم بتنفيذ الأمر التالي في الشل الخاص بك:

export PATH="/Users/test/.local/share/solana/install/active_release/bin:$PATH"
  1. تحديث متغير بيئة 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
  1. أعد تشغيل الطرفية أو قم بتشغيل الأمر التالي لتحديث جلسة الطرفية:
Terminal
$ 
source ~/.bashrc # If using Bash

$ 
source ~/.zshrc # If using Zsh
  1. تحقق من نجاح التثبيت عن طريق التحقق من إصدار واجهة سطر أوامر سولانا:
Terminal
$ 
solana --version

سترى مخرجات مثل ما يلي:

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

يمكنك عرض جميع الإصدارات المتاحة على مستودع Agave على Github. Agave هو عميل validator من Anza، المعروف سابقًا باسم عميل validator من سولانا Labs.

  1. قم بتحديث واجهة سطر أوامر سولانا إلى أحدث إصدار، حسب الحاجة (اختياري)
Terminal
$ 
agave-install update

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

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

المتطلبات الأساسية

ملف اختبار مشروع Anchor الافتراضي (TypeScript) الذي تم إنشاؤه باستخدام الأمر anchor init يتطلب Node.js و Yarn. (قالب اختبار Rust متاح باستخدام anchor init --test-template rust)

التثبيت

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

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

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

  1. قم بتثبيت AVM باستخدام الأمر التالي:
Terminal
$ 
cargo install --git https://github.com/solana-foundation/anchor avm --force
  1. تأكد من نجاح تثبيت AVM:
Terminal
$ 
avm --version
  1. قم بتثبيت واجهة سطر أوامر Anchor باستخدام AVM:

لتثبيت أحدث إصدار:

Terminal
$ 
avm install latest

$ 
avm use latest

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

Terminal
$ 
avm install 0.30.1

$ 
avm use 0.30.1

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

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

إذا رأيت رسالة الخطأ هذه، اتبع هذه الخطوات:

  1. قم بتثبيت التبعيات المذكورة في قسم Linux في أعلى هذه الصفحة.
  2. أعد محاولة تثبيت واجهة سطر أوامر Anchor.
  1. تحقق من نجاح التثبيت، من خلال التحقق من إصدار واجهة سطر أوامر Anchor:
Terminal
$ 
anchor --version

سترى مخرجات مثل ما يلي:

anchor-cli 0.31.1

لا تنس تشغيل أمر avm use لتحديد إصدار واجهة سطر أوامر Anchor الذي سيتم تشغيله على نظامك.

  • إذا قمت بتثبيت الإصدار latest، قم بتشغيل avm use latest.
  • إذا قمت بتثبيت الإصدار 0.30.1، قم بتشغيل avm use 0.30.1.

إعداد أدوات الذكاء الاصطناعي لتطوير سولانا

يوضح هذا القسم إعداد أدوات الذكاء الاصطناعي الاختيارية التي يمكنك استخدامها لتسريع تطوير سولانا.

الأداةالوصفالرابط
MCPخادم MCP الذي يمكنك الاتصال به باستخدام المؤشر لتحسين تطوير سولانا بمساعدة الذكاء الاصطناعي.https://mcp.solana.com/
LLMs.txtوثائق محسنة لنماذج اللغة الكبيرة يمكنك استخدامها لتدريب نماذج اللغة الكبيرة على وثائق سولانا.https://solana.com/llms.txt

Is this page helpful?

السابق

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

التالي

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

جدول المحتويات

تعديل الصفحة

تدار بواسطة

© 2025 مؤسسة سولانا.
جميع الحقوق محفوظة.
سولانا
تواصل معنا