# راهنمای نصب نسخه تست آزادراه

این راهنما برای نصب نسخه آزمایشی افزونه آزادراه در مرورگر Chrome است. این نسخه هنوز از Chrome Web Store نصب نمی‌شود و باید به صورت دستی با روش `Load unpacked` نصب شود.

## فایل مورد نیاز

فایل ZIP نسخه تست را دریافت و از حالت فشرده خارج کنید:

`azadrah-0.1.0-test.zip`

بعد از استخراج، باید پوشه‌ای داشته باشید که داخل آن فایل `manifest.json` دیده شود.

> نکته مهم: پوشه استخراج‌شده را بعد از نصب حذف یا جابه‌جا نکنید. Chrome افزونه را از همان مسیر اجرا می‌کند.

## نصب در Chrome

1. مرورگر Chrome را باز کنید.
2. در نوار آدرس این مسیر را وارد کنید:

   `chrome://extensions`

3. گزینه `Developer mode` یا «حالت برنامه‌نویس» را از گوشه بالا فعال کنید.
4. روی دکمه `Load unpacked` کلیک کنید.
5. پوشه استخراج‌شده آزادراه را انتخاب کنید؛ همان پوشه‌ای که فایل `manifest.json` داخل آن است.
6. اگر Chrome پیام دسترسی‌ها را نمایش داد، برای نسخه تست تأیید کنید.
7. یک تب جدید باز کنید. آزادراه باید به عنوان صفحه New Tab نمایش داده شود.

## به‌روزرسانی نسخه تست

اگر نسخه جدیدی دریافت کردید:

1. فایل ZIP جدید را استخراج کنید.
2. محتوای پوشه قبلی را با نسخه جدید جایگزین کنید، یا پوشه جدید را در یک مسیر ثابت نگه دارید.
3. به `chrome://extensions` بروید.
4. روی دکمه Reload کارت افزونه آزادراه کلیک کنید.
5. یک تب جدید باز کنید و نسخه جدید را تست کنید.

## حذف افزونه

1. به `chrome://extensions` بروید.
2. کارت افزونه آزادراه را پیدا کنید.
3. روی `Remove` کلیک کنید.

## گزارش خطا و بازخورد

لطفا هنگام گزارش مشکل این موارد را ارسال کنید:

- نسخه سیستم عامل
- نسخه Chrome
- تصویر یا ویدیوی کوتاه از مشکل، اگر ممکن است
- توضیح کوتاه از کاری که انجام دادید و نتیجه‌ای که دیدید
- اینکه مشکل بعد از Reload افزونه یا بستن و باز کردن Chrome هم تکرار می‌شود یا نه

## نکته درباره فایل CRX

Chrome معمولا نصب مستقیم فایل `.crx` خارج از Chrome Web Store را برای کاربران عادی محدود یا مسدود می‌کند. برای تست محدود، روش `Load unpacked` ساده‌ترین راه است. برای ارائه گسترده‌تر، بهتر است افزونه به صورت `Unlisted` یا عمومی در Chrome Web Store منتشر شود.
