# التثبيت

::: info أخبار
🍎 **إضافة Safari الأصلية تم إطلاقها!** هي مجانية بالكامل وتدعم التثبيت بنقرة واحدة.
:::

اختر طريقك.

> ⚠️ ملاحظة: مدير المطالبات هو الميزة الوحيدة التي تدعم Gemini™ للمؤسسات.

## 1. متاجر الإضافات (موصى به)

أبسط طريقة للبدء. التحديثات تلقائية.

**Chrome / Brave / Opera / Vivaldi:**

[<img src="https://img.shields.io/badge/Chrome_Web_Store-Download-4285F4?style=for-the-badge&logo=google-chrome&logoColor=white" alt="التثبيت من سوق Chrome الإلكتروني" height="40"/>](https://chromewebstore.google.com/detail/iifacdnjakkhjjiengaffnegbndgingi?utm_source=github&utm_medium=docs&utm_campaign=organic_growth&utm_content=ar)

**Microsoft Edge:**

[<img src="https://img.shields.io/badge/Microsoft_Edge-Download-0078D7?style=for-the-badge&logo=microsoft-edge&logoColor=white" alt="التثبيت من وظائف Microsoft Edge الإضافية" height="40"/>](https://microsoftedge.microsoft.com/addons/detail/gemini-voyager/gibmkggjijalcjinbdhcpklodjkhhlne)

> ⚠️ سيتوقف دعم نسخة Edge Add-ons —— ستظل مثبّتة على الإصدار الحالي ولن تتلقى تحديثات بعد الآن. على مستخدمي Edge التثبيت من متجر Chrome الإلكتروني أعلاه؛ هذا الرابط يعمل على Edge أيضاً.

**Firefox:**

[<img src="https://img.shields.io/badge/Firefox_Add--ons-Download-FF7139?style=for-the-badge&logo=firefox&logoColor=white" alt="التثبيت من إضافات Firefox" height="40"/>](https://addons.mozilla.org/firefox/addon/gemini-voyager/)

## 2. الطريقة اليدوية (أحدث الميزات)

يمكن أن تكون عملية مراجعة متجر الويب بطيئة. إذا كنت تريد أحدث إصدار فوراً، فقم بالتثبيت يدوياً.

**لـ Chrome / Edge / Brave / Opera:**

1. قم بتنزيل أحدث `gemini-voyager-chrome-vX.Y.Z.zip` من [إصدارات GitHub](https://github.com/Nagi-ovo/gemini-voyager/releases).
2. قم بفك ضغط الملف.
3. افتح صفحة الإضافات في متصفحك (`chrome://extensions`).
4. قم بتمكين **وضع المطور** (أعلى اليسار أو اليمين حسب اللغة).
5. انقر فوق **تحميل إضافات غير حزمة** وحدد المجلد الذي قمت بفك ضغطه للتو.

**لـ Firefox:**

1. قم بتنزيل أحدث `gemini-voyager-firefox-vX.Y.Z.xpi` من [الإصدارات](https://github.com/Nagi-ovo/gemini-voyager/releases).
2. افتح مدير الإضافات (`about:addons`).
3. اسحب ملف `.xpi` وأفلته للتثبيت (أو انقر فوق أيقونة الترس ⚙️ -> **تثبيت إضافة من ملف**).

> 💡 ملف XPI موقع رسمياً من Mozilla ويمكن تثبيته بشكل دائم في جميع إصدارات Firefox.

## 3. Safari (macOS)

Safari يدعم الآن التوزيع المباشر! قم بتنزيل التطبيق الموقع مسبقاً:

1. قم بتنزيل <SafariDownloadLink>أحدث إصدار Safari (.dmg)</SafariDownloadLink>.
2. افتح الملف واتبع تعليمات التثبيت.
3. انقر نقراً مزدوجاً لتشغيل التطبيق.
4. قم بالتفعيل في **إعدادات Safari > الإضافات**.

> 💡 إصدار Safari موقع مباشرة للتوزيع — لا حاجة لتحويل Xcode!
>
> ⚠️ **القيود**: نظرًا لطبيعة Safari، فإن (أ) إزالة العلامة المائية (ب) تصدير الصور (يُنصح باستخدام PDF) غير مدعومة.

---

_إعداد التطوير؟ إذا كنت مطوراً وتتطلع للمساهمة، تحقق من [دليل المساهمة](https://github.com/Nagi-ovo/gemini-voyager/blob/main/.github/CONTRIBUTING.md) الخاص بنا._