آفلاین-اولین فعالیت های وب مورد اعتماد

Demián Renzulli

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

نمونه ای از این سناریو ممکن است پس از دانلود PWA توسط کاربر از Play Store انجام شود. بنابراین، اگر کاربر هنگام تلاش برای باز کردن برنامه برای اولین بار، اتصال نداشته باشد، سرویس‌کار هنوز برای نمایش صفحه بازگشتی آفلاین در دسترس نخواهد بود. صفحه خطای استاندارد نشان داده می شود که منجر به تجربه بدی می شود.

این راهنما نحوه نمایش فعالیت خود را در این شرایط با بررسی وضعیت شبکه قبل از راه‌اندازی فعالیت وب مورد اعتماد توضیح می‌دهد.

یک LauncherActivity سفارشی ایجاد کنید

اولین قدم ایجاد یک فعالیت راه‌انداز سفارشی است. این Activity که حاوی صفحه آفلاین است تا نشان دهد اولین باری که کاربر برنامه را باز می کند اتصالی وجود ندارد یا خیر.

Activity OfflineFirstTWALauncherActivity را فراخوانی کنید و آن را گسترش دهید: com.google.androidbrowserhelper.trusted.LauncherActivity .

import com.google.androidbrowserhelper.trusted.LauncherActivity;

public class OfflineFirstTWALauncherActivity extends LauncherActivity {

}

سپس، Activity را در AndroidManifest.xml ثبت کنید:

<activity android:name=".OfflineFirstTWALauncherActivity" android:theme="@style/Theme.Design.NoActionBar">
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
    <!-- Edit android:value to change the url opened by the Trusted Web Activity -->
    <meta-data android:name="android.support.customtabs.trusted.DEFAULT_URL" android:value="https://airhorner.com" />
    <!-- This intent-filter adds the Trusted Web Activity to the Android Launcher -->
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <!-- Edit android:host to handle links to the target URL -->
        <data android:host="airhorner.com" android:scheme="https" />
    </intent-filter>
</activity>

کد قبلی OfflineFirstTWALauncherActivity را به عنوان یک فعالیت راه‌انداز ثبت می‌کند و https://airhorner.com را به‌عنوان URL برای باز کردن هنگام راه‌اندازی TWA تعریف می‌کند.

سناریوهای آفلاین را مدیریت کنید

ابتدا، در داخل Activity، متد shouldLaunchImmediately() را نادیده بگیرید و آن را false برگردانید تا Trusted Web Activity فوراً راه اندازی نشود. همچنین می توانید چک های اضافی را قبل از راه اندازی اولیه اضافه کنید:

@Override
protected boolean shouldLaunchImmediately() {
    // launchImmediately() returns `false` so we can check connection
    // and then render a fallback page or launch the Trusted Web Activity with `launchTwa()`.
    return false;
}

برای بررسی وضعیت شبکه قبل از راه اندازی TWA، روش onCreate() را لغو کنید. یک فراخوانی به tryLaunchTwa() اضافه کنید، یک روش کمکی که حاوی این منطق است:

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    tryLaunchTwa();
}

سپس، tryLaunchTwa() پیاده سازی کنید:

private void tryLaunchTwa() {
    // If TWA has already launched successfully, launch TWA immediately.
    // Otherwise, check connection status. If online, launch the Trusted Web Activity with `launchTwa()`.
    // Otherwise, if offline, render the offline fallback screen.
    if (hasTwaLaunchedSuccessfully()) {
        launchTwa();
    } else if (isOnline()) {
        firstTimeLaunchTwa();
    } else {
        renderOfflineFallback();
    }
}

کد قبلی سه سناریو را مدیریت می کند:

• اگر TWA قبلاً راه‌اندازی شده باشد، سرویس‌کار ثبت شده است و PWA می‌تواند به صورت آفلاین پاسخ دهد. در آن صورت، launchTwa() که در کلاس والد تعریف شده است فراخوانی کنید تا فعالیت وب مورد اعتماد را مستقیماً راه اندازی کنید.
• اگر TWA قبلاً راه‌اندازی نشده است و کاربر آنلاین است، برای اولین بار با استفاده از متد firstTimeLaunchTwa() که بعداً پیاده‌سازی می‌کنید، فعالیت وب مورد اعتماد را راه‌اندازی کنید.
• اگر TWA قبلاً راه اندازی نشده است و کاربر آفلاین است، صفحه بازگشتی آفلاین بومی را رندر کنید.

روش های کمکی را اجرا کنید

مرحله آخر پیاده سازی متدهای کمکی است که توسط کد قبلی فراخوانی شده اند. این کد برای بررسی وضعیت آفلاین isOnline() است:

private boolean isOnline() {
    ConnectivityManager connectivityManager = (ConnectivityManager) getSystemService(Context.CONNECTIVITY_SERVICE);
    NetworkInfo activeNetworkInfo = connectivityManager.getActiveNetworkInfo();
    return activeNetworkInfo != null && activeNetworkInfo.isConnected();
}

سپس، hasTwaLaunchedSuccessfully() را پیاده سازی کنید، که بررسی می کند آیا TWA حداقل یک بار راه اندازی شده است یا خیر:

private boolean hasTwaLaunchedSuccessfully() {
    // Return `true` if the preference "twa_launched_successfully" has already been set.
    SharedPreferences sharedPref = getSharedPreferences(getString(R.string.twa_offline_first_preferences_file_key), Context.MODE_PRIVATE);
    return sharedPref.getBoolean(getString(R.string.twa_launched_successfully), false);
}

کد قبلی launchTWA() از کلاس والد فراخوانی می کند و پرچم twa_launched_successfully را در تنظیمات برگزیده مشترک ذخیره می کند. این نشان می دهد که TWA حداقل یک بار با موفقیت راه اندازی شده است.

روش کمکی باقی مانده، renderOfflineFallback() یک صفحه آفلاین اندروید را ارائه می کند.

private void renderOfflineFallback() {
    setContentView(R.layout.activity_offline_first_twa);

    Button retryBtn = this.findViewById(R.id.retry_btn);
    retryBtn.setOnClickListener(new View.OnClickListener() {
        public void onClick(View v) {
            // Check connection status. If online, launch the Trusted Web Activity for the first time.
            if (isOnline()) firstTimeLaunchTwa();
        }
    });
}

برای دموی او، طرح‌بندی activity_offline_first_twa را تعریف کرده‌ایم که حاوی دکمه‌ای برای تلاش مجدد است، که به مرور زمان، پس از بررسی اتصال، firstTimeLaunchTwa() را اجرا می‌کند.

نتیجه گیری

• اولین باری که کاربر یک برنامه وب پیشرو (PWA) را از طریق فعالیت وب معتمد راه اندازی می کند، سرویس دهنده هنوز در دسترس نخواهد بود.
• برای جلوگیری از نمایش صفحه استاندارد آفلاین در صورتی که کاربر اتصالی نداشته باشد، می توانید وضعیت آفلاین را تشخیص داده و به جای آن یک صفحه آفلاین بازگشتی نشان دهید.
• در این راهنما نحوه اجرای آن استراتژی را یاد گرفتید. اگر علاقه مند به بررسی کدی هستید که ما در این راهنما استفاده کرده ایم، می توانید راه حل کامل را در نسخه آفلاین First TWA بیابید.