Skip to main content

 

 

 

 

Template:OutSystems/Documentation_KB/Breadcrumb_New_Layout

 

 

Template:OutSystems/OSLanguageSwitcher

 

モバイルアプリにのみ適用されます

 

 

OutSystems

プログレッシブWebアプリ(PWA)として配布

プログレッシブWebアプリ(PWA)は、ネイティブアプリを配布することなく、ネイティブのようなエクスペリエンスを提供します。PWAは既存のWeb開発手法と最新ブラウザの機能を組み合わせた新しいテクノロジーです。

PWAの主な利点は以下のとおりです。

  • 管理を効率化できます。ネイティブモバイルアプリと異なり、アプリストアを必要としません。
  • Webブラウザテクノロジーに基づき、プラットフォームに依存しません。AndroidとiOSで同じアプリを実行できます。また、OutSystemsではアプリをPWAおよびAndroid/iOS用のネイティブビルドとして配布できます。
  • 変更をOutSystems環境にパブリッシュするとただちに更新されます。
  • ユーザーデバイスのシステムリソースへの負荷が軽量です。
  • OutSystemsでPWAを開発すると、ローコード開発のメリットをフル活用できます。それだけでアプリのPWA配布を有効にする意義は十分です。

OutSystemsでは、PWAはモバイルアプリの配布モードです。モバイルアプリはモバイルアプリランタイムに含まれ、このタイプのデフォルトのアプリテンプレートはPhone AppTablet Appです。PWAとしてユーザーに適用する新しいアプリをService Studioで作成する場合、それらを選択します。モバイルアプリをネイティブモバイルアプリとPWAの両方として同時に配布することができます。

前提条件

アプリをPWAとして配布するには、以下が必要です。

  • Service Studio 11.6以降
  • Platform Server 11.9以降
  • LifeTime Oct.2019 CP1以降
  • HTTPS通信を行うことができる有効なSSL証明書

アプリを作成してPWAを有効にする

モバイルアプリを作成し、アプリの詳細で[Distribute as PWA]トグルをオンにします。

  1. 新しいアプリの作成を開始し、[New Application]ウィンドウで[Phone App]または[Tablet App]アプリテンプレートを選択します。

    新しいスマホアプリまたはタブレットアプリ

    既存のモバイルアプリでPWA配布を有効にできます。ユーザーエクスペリエンスで、モバイルアプリがネイティブAndroidビルドまたはiOSビルドでのみ動作するネイティブプラグインを使用しているかどうかを確認します。

  2. アプリに画面とロジックを追加します。

  3. アプリをパブリッシュします。

  4. アプリの詳細の[Distribute]タブで、[Distribute as PWA]トグルをオンにします。[Distribute]タブを見つけるには、Service Studioのホーム画面に戻り、アプリケーションアイコンをクリックします。

    プログレッシブWebアプリの配布をアクティベートするPWAトグル

Distribute as PWA]の値を変更した後、アプリを再パブリッシュする必要はありません。この変更はただちに有効になります。

モバイル(特に軽量なローカルストレージの設計に関するベストプラクティスは、PWAの開発にも適用されます。

PWAを実行する

PWAの実行手順を以下に示します。Service Studioでアプリの詳細に移動し、[Distribute]タブをクリックします。

  • モバイルデバイスでPWAを開くには、QRコードをスキャンします。
  • デスクトップブラウザでPWAを開くには、リンクをクリックします。

プログレッシブWebアプリを実行するためのQRコードとリンク

AndroidのPWA

AndroidデバイスでPWAをインストールして実行するには、以下の手順を実行します。

  1. ChromeでアプリのURLにアクセスします。

  2. Add (my app) to Home screen]バナーをタップします。

    Androidへのアプリのインストール

  3. Androidのホーム画面にショートカットが追加されたことを確認したら、ストアからインストールした他のアプリと同様にアプリを開きます。他のAndroidアプリと同様にアンインストールすることができます。

    Androidのホーム画面のPWA

iOSのPWA

iOSデバイスでPWAをインストールして実行するには、以下の手順を実行します。

  1. SafariでアプリのURLにアクセスします。

  2. [Share]ボタンをタップします。共有メニューが開きます。

    iOSのSafariのShareボタン

  3. Add to home screen]をタップします。確認画面が開きます。

    iOSの共有オプション

  4. 確認画面で、[Add]をタップします。

    iPhoneのホーム画面への追加を確認する

  5. これで、アプリがホーム画面に表示されます。他のiOSアプリと同様にアンインストールすることができます。

    iOSの共有オプションによりホーム画面に追加する

PWAをカスタマイズする

以下の方法でアプリをカスタマイズできます。

  • アプリの詳細画面で詳細を編集する。
  • 拡張構成でPWAマニフェストの設定を上書きする。

PWAのプロパティを変更する

Service StudioのUIを使用して、アプリの名前、説明、色、ロゴを編集できます。必ずアプリを再パブリッシュしてください。

Service Studioで編集可能なマニフェスト値

マニフェストはService Studioによって自動的に生成されます。マニフェストの変更は、値を上書きする必要がある場合にのみ行います。Service StudioのUIから以下のマニフェストオプションを編集できます。

Service Studioのプロパティ マニフェストキー
アプリケーション名 name
アプリケーションの説明 description
アプリの初期色 theme_color
アプリケーションのロゴ* icons

(*)Service Studioによって、4つの必要なアイコンの解像度が生成されます。

マニフェスト設定を上書きする

OutSystemsは、LifeTimeでPWAの拡張構成を上書きすることができない問題を特定しました。開発チームが修正作業を行っています。ただし、Service Studioでは引き続き拡張構成を使用できます。

LifeTimeのPWAマニフェストによってService Studioのマニフェストが上書されることに留意します。

マニフェストを使用すると、Service Studioで設定した値が上書きされます。[Extensibility Configurations]フィールドのJSONの[PWAManifest]セクションでマニフェストを使用する必要があります。以下の2箇所でマニフェストを編集できます。

  • Service Studioでは、すべての環境で、すべてのUI設定がマニフェストによって上書きされます。モジュールのプロパティの[Extensibility Configurations]フィールドでJSONマニフェストを編集します。
  • LifeTimeでは、現在の環境のみで、すべてのUI設定がマニフェストによって上書きされます。[Extensibility Configurations]フィールドは、[Applications > (アプリ名) > Settings > Advanced > Extensibility Configurations]にあります。

マニフェストのリソースとサンプルJSON

Web App Manifest Generatorを使用してマニフェストを生成したり、このサンプルでテストを行ったりすることができます。

{ 
    "PWAManifest":{ 
        "name":"Name overridden",
        "short_name":"ShortName overridden",
        "description":"Description overridden",
        "theme_color":"#EDEDED",
        "background_color":"black",
        "dir":"ltr",
        "orientation": "portrait",
        "serviceworker":{ 
            "src":"/PWAServiceWorker/scripts/PWAServiceWorker.ServiceWorker.js"
        }
    }
}

このJSONは、PWAとプラグインの両方で使用できます。

iOSのPWAのインストールプロンプト

プロンプトを使用して、アプリのPWAバージョンをインストールできることをユーザーに知らせることができます。iOSデバイスの場合、コミュニティで提供されているPrompt to Install PWAプラグインを試すか、カスタムソリューションを開発します。

iOSのPWAのインストールプロンプト

Android(Chrome)の場合、インストールプロンプトがネイティブで提供されているためプラグインは不要です。

PWAでプラグインを使用する{#plugins}

PWAで正式にサポートされているプラグインは以下のとおりです。

まもなく他のプラグインも追加されます。また、独自のプラグインをForgeに投稿することもできます。

PWAをデバッグする

PWAをデバッグするには、Google Chromeでアプリをエミュレートします。[Debugger]タブに移動し、[Debug Setup]で[Emulate using Chrome]を選択します。

PWAデバッガの有効化

トラブルシューティング

PWAを修正するときのトラブルシューティングに役立つヒントを以下に示します。

トグルボタンが有効でない

まだアプリを再パブリッシュしていない場合は、開発インフラでアプリを再パブリッシュしてから[Distribute as PWA]トグルをオンにします。新しい機能が正しく動作するには、Platform Serverのアップグレードリストの指示に従って、Platform Serverをアップグレードした後にアプリを再パブリッシュする必要があります。

無効なPWAのホームURLを取得している

環境のURLと一致するURL(例: https://example.com/)を取得しているためにPWAを読み込むことができない場合、アプリのホームモジュールを設定しているかどうかを確認します。

アプリの詳細画面を開きます。[Test in browser]ボタンが無効になっている場合は、アプリのモジュールが定義されていません。モジュールをホームモジュールに設定するには、そのモジュール名の右側にある巻き矢印アイコンをクリックします。PWAの読み込みを再試行します。

ホームモジュールの設定

PWAのデバッグが開始しない

PWAのデバッグを開始すると、[Waiting for application]ウィンドウが開いたままになり、何も起こりません。

この問題を修正するには、デバッガを[Emulate using Chrome]に設定してから[Start debugging]をクリックします。デバッガの[Android device]オプションと[iOS device]オプションは、アプリがネイティブビルドとして配布されている場合のみ使用でき、アプリがPWAとして配布されている場合は使用できません。

LifeTimeで拡張構成を適用した場合に上書きすることができない

LifeTimeで拡張構成を適用してマニフェストを上書きする場合に関する問題があります。チームが修正作業を行っています。ただし、Service Studioでは引き続き拡張構成を使用できます。

iOSでPWAがインストールされない

Platform Server 11.7以前およびiOS 13以降を使用している場合は、以下のいずれかを行う必要があります。

  • Platform Server 11.8以降へのアップグレード

  • Web SQLの無効化[Settings > Safari > Advanced > Experimental Features]に移動し、[Disable Web SQL]がオフになっていることを確認します。

    iOSのSafariのWeb SQLの設定

PWAはiOS 13.0~13.2では動作しない

iOSバージョン13.0~13.2でPWAが正しく動作しないというiOSのバグがあります。この問題を修正するには、iOS 13.3以降を使用してください。

PWAが低速でクエリの実行に時間がかかりすぎる

PWAのパフォーマンスが悪くクエリの実行に時間がかかりすぎる場合は、ローカルストレージモデルが複雑すぎる可能性やアプリで処理する必要があるデータの量が多すぎる可能性があります。詳細については、軽量なローカルストレージの設計に関する推奨事項をご覧ください。

PWAを有効にすると「not connected to the environment」というエラーが表示される

PWAを有効にしようとしたとき、Service Studioで「There was an error connecting to your development environment. Confirm your connection and retry.」というエラーが表示されます。

この問題を修正するには以下の方法を試してください。

  • 「https」から始まる環境のURLを入力してService Studioに接続します。たとえば、http://myenvironment.example.comに接続する代わりに、https://myenvironment.example.comに接続します。その後、PWAの有効化を再試行します。

  • 有効で適切なSSL証明書が構成されているか確認します。モバイルアプリをネイティブビルドやPWAとして配布するには、サーバーとセキュアな通信を行うための証明書が必要です。詳細については、「HTTPSセキュリティを適用する」の注記をご覧ください。

実行時エラーがある

アプリのローカルデータを削除してみます。ブラウザで設定を探し、アプリのインストールドメインのデータを消去します。Chromeの場合、[Settings > Site Settings > Cookies and site data > See all cookies and site data]に移動し、ドメインを検索してデータを消去します。