وباپ فلاتر خود را روی آیفون و اندروید نصبشدنی کنید
پیش از شروع
- یک اپ فلاتر با خروجی وب (web/manifest.json با نام، background_color و آیکونها)
- ابرووا پوش برای فلاتر وب (سرویسورکر آن در ریشهی سایت)
- گوگل کروم روی کامپیوتر شما، برای تصاویر اسپلش آیفون
در این راهنما یک وباپ فلاتر را به اپی تبدیل میکنید که کاربر به صفحهی اصلی گوشیاش اضافه میکند و مثل هر اپ دیگری باز میکند. یک پکیج، abrova_web، این کار را انجام میدهد: یک دستور صفحهی شروع، تصاویر اسپلش آیفون و آیپد و صفحهی آفلاین را میسازد، یک ویجت به کاربر نشان میدهد هر جا اپ را باز کرده چطور نصبش کند، و دو ویجت دیگر وقتی نسخهی تازه آمده خبرش میکنند.
در آیفون، Web Push فقط در اپی کار میکند که به صفحهی اصلی اضافه شده. اپ نصبشده از آیکون خودش و با صفحهی شروع خودش هم باز میشود.
مرحله ۱: پکیج را از Abrova Center اضافه کنید#
پکیج از Abrova Center میآید. آن را با مخزن ابرووا بهعنوان منبع hosted اضافه کنید:
# pubspec.yaml
dependencies:
abrova_web:
hosted: https://center.abrova.ir/api/packages/abrova/pub
version: ^0.5.4سپس نصب کنید:
flutter pub get
مرحله ۲: صفحهی شروع، تصاویر اسپلش و صفحهی آفلاین#
صفحهی آفلاین را سرویسورکر ابرووا پوش در ریشهی سایت شما سرو میکند (AbrovaPushConfig(webPush: true, webPushAtRoot: true))، پس اول آن را راه بیندازید (Web Push در Flutter) و بعد setup را اجرا کنید:
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 را جایی بگذارید که کاربر میبیند، مثلاً بالای صفحهی اصلی:
import 'package:abrova_web/abrova_web.dart';
AbrovaInstallGuide(appName: 'Lino', icon: Image.asset('assets/icon.png'))فقط چیزی را نشان میدهد که همانجا که اپ باز است لازم است:
| اپ کجا باز است | کاربر چه میبیند |
|---|---|
| آیفون یا آیپد، Safari | Share › Add to Home Screen › باز کردن از آیکون، با شبیه کنترلهای آیفون |
| مرورگر اندروید | دکمهی نصب (پیام نصب مرورگر)، یا قدمهای منو |
| داخل اینستاگرام، فیسبوک یا اپ دیگر | باز کردن در مرورگر، با دکمهی کپی لینک |
| نصبشده | در اولین باز شدن از صفحهی اصلی، یک بار «روی صفحهی اصلی شماست»؛ بعد از آن هیچ چیز |
| روی کامپیوتر، یا بیلد نیتیو | هیچ چیز |
متنهایش برای locale fa فارسی و در غیر این صورت انگلیسی است؛ برای متنهای خودتان strings: را بدهید. «بعداً» آن را ۷ روز پنهان میکند (dismissDays).
برای اینکه خودتان تصمیم بگیرید، بخوانید اپ کجا اجرا میشود:
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 را جایی نشان دهید که کاربر نگاه میکند:
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 را اضافه کنید:
{ "minimum": "0.6.0", "notes": { "en": "Faster sign-in.", "fa": "ورود سریعتر." } }صفحهای که نسخهای قدیمیتر از minimum را اجرا میکند تا بارگذاری دوباره زیر AbrovaUpdateGate پوشانده میماند و notes بهعنوان «تازهها» نمایش داده میشود. جزئیات: نسخههای تازه (وب).
مرحله ۵: بیلد و انتشار#
با فایلهای موتور داخل بیلد بیلد بگیرید و به هر انتشار شمارهی بیلد خودش را بدهید:
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، بماند.
مرحله ۶: بررسی کنید که کار کرد#
- در آیفون، اپ را در Safari باز کنید: راهنمای نصب قدمهای Share › Add to Home Screen را نشان میدهد. اضافهاش کنید و از آیکون بازش کنید: تصویر اسپلش و صفحهی شروع دیده میشوند و راهنما به جای قدمها یک بار «روی صفحهی اصلی شماست» را نشان میدهد.
- در اندروید، آن را در Chrome باز کنید: راهنما دکمهی نصب را نشان میدهد.
- لینک را داخل اینستاگرام باز کنید: راهنما میخواهد آن را در مرورگر باز کنید، با دکمهی کپی لینک.
- حالت پرواز را روشن کنید و اپ نصبشده را باز کنید: صفحهی آفلاین دیده میشود. شبکه را دوباره روشن کنید: اپ دوباره بارگذاری میشود.
- دوباره با
--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 تازه، صفحههای باز انتشاری را که نسخهاش عوض نشده نمیبینند.
بعدی: راهنمای نصب (وب)