ابرووا
شروع رایگان

وب‌اپ فلاتر خود را روی آیفون و اندروید نصب‌شدنی کنید

در پایان: وب‌اپ فلاتری که کاربر به صفحه‌ی اصلی گوشی اضافه می‌کند، با صفحه‌ی شروع، تصاویر اسپلش آیفون، صفحه‌ی آفلاین، راهنمای نصب و پیام نسخه‌ی تازه.
ابرووا پوشFlutter webمبتدی · ۲۰ دقیقه

پیش از شروع

وب‌اپ فلاترabrova_webاپ روی صفحه‌ی اصلی

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

چرا نصب.

در آیفون، Web Push فقط در اپی کار می‌کند که به صفحه‌ی اصلی اضافه شده. اپ نصب‌شده از آیکون خودش و با صفحه‌ی شروع خودش هم باز می‌شود.

مرحله ۱: پکیج را از Abrova Center اضافه کنید#

پکیج از Abrova Center می‌آید. آن را با مخزن ابرووا به‌عنوان منبع hosted اضافه کنید:

yaml
# pubspec.yaml
dependencies:
  abrova_web:
    hosted: https://center.abrova.ir/api/packages/abrova/pub
    version: ^0.5.4

سپس نصب کنید:

bash
flutter pub get

مرحله ۲: صفحه‌ی شروع، تصاویر اسپلش و صفحه‌ی آفلاین#

صفحه‌ی آفلاین را سرویس‌ورکر ابرووا پوش در ریشه‌ی سایت شما سرو می‌کند (AbrovaPushConfig(webPush: true, webPushAtRoot: true))، پس اول آن را راه بیندازید (Web Push در Flutter) و بعد setup را اجرا کنید:

bash
dart run abrova_push:web_push_setup --root
dart run abrova_web:setup --accent "#1C72C8"

نام اپ، background_color و آیکون‌ها را از web/manifest.json می‌خواند (--accent رنگ درخشش، نوار بارگذاری و دکمه است) و این‌ها را می‌سازد:

  • صفحه‌ی شروع در web/index.html که تا کشیده شدن اولین فریم اپ دیده می‌شود؛
  • تصاویر اسپلش آیفون و آیپد در web/splash/ و تگ‌هایشان در web/index.html (به Google Chrome نیاز دارد؛ --no-splash آن‌ها را نمی‌سازد)؛
  • فایل web/offline.html که به web/abrova-push-sw.js اضافه می‌شود.

حالا با زدن آیکون در صفحه‌ی اصلی، تصویر اسپلش فوراً دیده می‌شود و بعد صفحه‌ی شروع با نوار بارگذاری تا اپ ظاهر شود. وقتی اپ بدون اینترنت باز شود، «اینترنت وصل نیست» را با دکمه‌ی «دوباره امتحان کنید» نشان می‌دهد و به محض برگشتن اتصال خودش دوباره بارگذاری می‌شود. صفحه‌ی آفلاین وقتی کار می‌کند که اپ یک بار با اینترنت و با پوشِ راه‌افتاده باز شده باشد.

بعد از ارتقای abrova_push و هر بار که manifest یا آیکون‌ها تغییر کردند، هر دو دستور را دوباره اجرا کنید. جزئیات: صفحه‌ی شروع و صفحه‌ی آفلاین.

مرحله ۳: راهنمای نصب را نشان دهید#

AbrovaInstallGuide را جایی بگذارید که کاربر می‌بیند، مثلاً بالای صفحه‌ی اصلی:

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

AbrovaInstallGuide(appName: 'Lino', icon: Image.asset('assets/icon.png'))

فقط چیزی را نشان می‌دهد که همان‌جا که اپ باز است لازم است:

اپ کجا باز استکاربر چه می‌بیند
آیفون یا آیپد، SafariShare › Add to Home Screen › باز کردن از آیکون، با شبیه کنترل‌های آیفون
مرورگر اندرویددکمه‌ی نصب (پیام نصب مرورگر)، یا قدم‌های منو
داخل اینستاگرام، فیس‌بوک یا اپ دیگرباز کردن در مرورگر، با دکمه‌ی کپی لینک
نصب‌شدهدر اولین باز شدن از صفحه‌ی اصلی، یک بار «روی صفحه‌ی اصلی شماست»؛ بعد از آن هیچ چیز
روی کامپیوتر، یا بیلد نیتیوهیچ چیز

متن‌هایش برای locale ‏fa فارسی و در غیر این صورت انگلیسی است؛ برای متن‌های خودتان strings: را بدهید. «بعداً» آن را ۷ روز پنهان می‌کند (dismissDays).

برای این‌که خودتان تصمیم بگیرید، بخوانید اپ کجا اجرا می‌شود:

dart
final where = AbrovaWeb.context;
where.installed;     // opened from the Home Screen
where.installNeed;   // none, iosAddToHomeScreen, androidInstall, openInBrowser
where.inAppBrowser;  // 'Instagram', … or null

وقتی where.installed درست شد، اجازه‌ی اعلان بخواهید. جزئیات: راهنمای نصب (وب).

مرحله ۴: نسخه‌ی تازه را به کاربر اطلاع دهید#

بررسی به‌روزرسانی را در main شروع کنید، برای به‌روزرسانی‌های اجباری اپ را با AbrovaUpdateGate بپوشانید و AbrovaUpdatePrompt را جایی نشان دهید که کاربر نگاه می‌کند:

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

void main() {
  AbrovaWebUpdates.start();
  runApp(MaterialApp(
    builder: (context, child) => AbrovaUpdateGate(child: child!),
    home: const HomePage(),
  ));
}

// For example at the top of the home page:
AbrovaUpdatePrompt(icon: Image.asset('assets/icon.png'))

بعد از هر انتشار، پیام «نسخه‌ی تازه آماده است» را با دکمه‌های بارگذاری دوباره و بعداً نشان می‌دهد. هنگام باز شدن اپ، هنگام برگشتن آن به جلو و هر ۱۰ دقیقه بررسی می‌کند.

وقتی نسخه‌ای قدیمی باید متوقف شود، web/update.json را اضافه کنید:

json
{ "minimum": "0.6.0", "notes": { "en": "Faster sign-in.", "fa": "ورود سریع‌تر." } }

صفحه‌ای که نسخه‌ای قدیمی‌تر از minimum را اجرا می‌کند تا بارگذاری دوباره زیر AbrovaUpdateGate پوشانده می‌ماند و notes به‌عنوان «تازه‌ها» نمایش داده می‌شود. جزئیات: نسخه‌های تازه (وب).

مرحله ۵: بیلد و انتشار#

با فایل‌های موتور داخل بیلد بیلد بگیرید و به هر انتشار شماره‌ی بیلد خودش را بدهید:

bash
flutter build web --release --no-web-resources-cdn --build-number=13

--no-web-resources-cdn فایل‌های موتور Flutter (CanvasKit) را در build/web می‌گذارد، پس اپ آن‌ها را از سایت خودتان بارگذاری می‌کند، نه از سرورهای Google. شماره‌ی بیلد باعث می‌شود صفحه‌های باز انتشار تازه را ببینند: وقتی فقط بیلد عوض شده باشد، پیام «نسخه‌ی 0.5.1 (ساخت 13)» را نشان می‌دهد.

کل پوشه‌ی build/web را، همان‌طور که امروز منتشر می‌کنید، در ریشه‌ی سایت بارگذاری کنید. abrova-push-sw.js باید در ریشه، کنار index.html، بماند.

مرحله ۶: بررسی کنید که کار کرد#

  1. در آیفون، اپ را در Safari باز کنید: راهنمای نصب قدم‌های Share › Add to Home Screen را نشان می‌دهد. اضافه‌اش کنید و از آیکون بازش کنید: تصویر اسپلش و صفحه‌ی شروع دیده می‌شوند و راهنما به جای قدم‌ها یک بار «روی صفحه‌ی اصلی شماست» را نشان می‌دهد.
  2. در اندروید، آن را در Chrome باز کنید: راهنما دکمه‌ی نصب را نشان می‌دهد.
  3. لینک را داخل اینستاگرام باز کنید: راهنما می‌خواهد آن را در مرورگر باز کنید، با دکمه‌ی کپی لینک.
  4. حالت پرواز را روشن کنید و اپ نصب‌شده را باز کنید: صفحه‌ی آفلاین دیده می‌شود. شبکه را دوباره روشن کنید: اپ دوباره بارگذاری می‌شود.
  5. دوباره با --build-number=14 منتشر کنید: اپ باز پیام «نسخه‌ی تازه آماده است» را نشان می‌دهد.

رفع مشکل#

صفحه‌ی آفلاین سرو نمی‌شود: web/abrova-push-sw.js وجود ندارد

اول dart run abrova_push:web_push_setup --root را اجرا کنید و بعد دوباره dart run abrova_web:setup را.

تصاویر اسپلش ساخته نشدند

setup برای کشیدن آن‌ها به Google Chrome نیاز دارد (اگر پیدا نشد، CHROME را برابر مسیر آن بگذارید) و به یک فایل آیکون در web/manifest.json.

بعد از انتشار پیام نسخه‌ی تازه نمی‌آید

AbrovaWebUpdates.start() را در main صدا بزنید و هر انتشار را با ‎--build-number تازه بیلد بگیرید.

دام‌ها
  • در آیفون Web Push فقط در اپِ افزوده به صفحه‌ی اصلی کار می‌کند: وقتی AbrovaWeb.context.installed درست شد اجازه‌ی اعلان بخواهید.
  • صفحه‌ی آفلاین را web/abrova-push-sw.js سرو می‌کند: abrova_push:web_push_setup --root را پیش از abrova_web:setup اجرا کنید و بعد از ارتقای abrova_push یا تغییر manifest و آیکون‌ها هر دو را دوباره اجرا کنید.
  • بدون ‎--build-number تازه، صفحه‌های باز انتشاری را که نسخه‌اش عوض نشده نمی‌بینند.

بعدی: راهنمای نصب (وب)