---
title: "راهنمای نصب (وب)"
description: "یک ویجت که به کاربر نشان می‌دهد اپ وب فلاتر شما را کجا و چطور نصب کند: Safari آیفون، اندروید و مرورگرهای داخل اپ مثل اینستاگرام. فارسی و انگلیسی."
product: push
language: fa
url: https://abrova.ir/docs/push/install-guide
updated: 2026-11-15
---

# راهنمای نصب (وب)

یک ویجت که به کاربر نشان می‌دهد اپ وب فلاتر شما را کجا و چطور نصب کند: Safari آیفون، اندروید و مرورگرهای داخل اپ مثل اینستاگرام. فارسی و انگلیسی.

> **اعلان به اپ نصب‌شده نیاز دارد**
>
> در آیفون، Web Push فقط در اپی کار می‌کند که به صفحه‌ی اصلی اضافه شده. `abrova_web` هر جا اپ باز شود قدم‌های درست را نشان می‌دهد و بعد از نصب چیزی نشان نمی‌دهد.

## مرحله 1: پکیج را اضافه کنید

```yaml
dependencies:
  abrova_web:
    hosted: https://center.abrova.ir/api/packages/abrova/pub
    version: ^0.1.0
```

## مرحله 2: راهنما را نشان دهید

```dart
import 'package:abrova_web/abrova_web.dart';

AbrovaInstallGuide(appName: 'لینو', icon: Image.asset('assets/icon.png'))
```

| اپ کجا باز است | کاربر چه می‌بیند |
| --- | --- |
| `آیفون یا آیپد، Safari` | Share › Add to Home Screen › باز کردن از آیکون، با شبیه کنترل‌های آیفون |
| `مرورگر اندروید` | دکمه‌ی نصب (پیام نصب مرورگر) یا قدم‌های منو |
| `داخل اینستاگرام، فیسبوک یا اپ دیگر` | باز کردن در مرورگر، با کپی لینک |
| `نصب‌شده، کامپیوتر یا نسخه‌ی نیتیو` | هیچ |

| گزینه | پیش‌فرض | کارش |
| --- | --- | --- |
| `appName` | الزامی | نام اپ شما، همان‌طور که زیر آیکون است |
| `icon` | یک آیکون عمومی | آیکون اپ شما در سربرگ |
| `accentColor` | رنگ اصلی تم | رنگ سربرگ |
| `strings` | فارسی برای fa، وگرنه انگلیسی | متن‌های خودتان |
| `dismissDays` | 7 | مدتی که «بعداً» آن را پنهان می‌کند |

## مرحله 3: اپ کجا اجرا می‌شود

```dart
final where = AbrovaWeb.context;
where.installed;     // از صفحه‌ی اصلی باز شده
where.installNeed;   // none، iosAddToHomeScreen، androidInstall، openInBrowser
where.inAppBrowser;  // 'Instagram'، … یا null
```

همراه [Web Push](https://abrova.ir/docs/push/flutter#web-push): وقتی `where.installed` درست بود اجازه‌ی اعلان بگیرید. برای نسخه‌های تازه‌ی اپ، [نسخه‌های تازه (وب)](https://abrova.ir/docs/push/web-updates) را ببینید.
