AndroidアプリでのWebページのレンダリング
ご覧のページは、お客様の利便性のために一部機械翻訳されています。また、ドキュメントは頻繁に更新が加えられており、翻訳は未完成の部分が含まれることをご了承ください。最新情報は都度公開されておりますため、必ず英語版をご参照ください。翻訳に問題がある場合は、こちらまでご連絡ください。
レンダリングWebコンテンツ チュートリアルでは、AndroidアプリのLiferay DXPサイトから Webコンテンツ を表示する方法を示します。コンテンツの表示は素晴らしいですが、ページ全体を表示したい場合はどうでしょうか？ 問題ない\！ Webスクリーンレット では、任意のWebページを表示できます。 ローカルまたはリモートのJavaScriptファイルとCSSファイルを挿入して、ページをカスタマイズすることもできます。 Liferay DXPのサーバー側カスタマイズ機能（例： アプリケーション表示テンプレート）と組み合わせると、Web ScreenletはAndroidアプリでWebページを表示するためのほぼ無限の可能性を提供します。
このチュートリアルでは、Web Screenletを使用して、AndroidアプリでWebページを表示する方法を学びます。
アプリにWebスクリーンレットを挿入する
アプリにWebスクリーンレットを挿入することは、アプリにスクリーンレットを挿入する と同じです：
-
スクリーンレットを使用するアクティビティまたはフラグメントのレイアウトにスクリーンレットのXMLを挿入します。 また、必要な属性を必ず設定してください。 ウェブScreenletの使用可能な属性のリストについては、 属性セクション のWeb Screenlet参照ドキュメントのを。
たとえば、スクリーンレットの
layoutIdおよびautoLoad属性がそれぞれweb_defaultおよびfalseに設定されたWebスクリーンレットのXMLは次のとおりです。<com.liferay.mobile.screens.web.WebScreenlet android:id="@+id/web_screenlet" android:layout_width="match_parent" android:layout_height="match_parent" app:layoutId="@layout/web_default" app:autoLoad="false" />web_defaultは、デフォルトのビューセットの一部であるスクリーンレットのデフォルトビューを指定することに注意してください。 -
デフォルトビューなど、ビューセットの一部であるビューを使用するには、アプリまたはアクティビティテーマが、ビューセットのスタイルを設定するテーマを継承する必要があります。 デフォルトビューセットの場合、これは
default_themeです。 たとえば、default_themeを継承するようにアプリのテーマを設定するには、res / values / styles.xmlを開き、ベースアプリテーマの親をdefault_themeます。 この例では、ベースアプリのテーマはAppThemeです。<style name="AppTheme" parent="default_theme"> ...
次に、Web Screenletのリスナーを実装します。
Web Screenletのリスナーの実装
アクティビティまたはフラグメントでScreenletを使用するには、そのアクティビティまたはフラグメントのクラスにScreenletのリスナーも実装する必要があります。 Web Screenletのリスナーは WebListenerです。 WebListenerを実装するには、次の手順に従います。
-
クラス宣言を変更して
WebListenerを実装し、com.liferay.mobile.screens.web.WebListenerをインポートします。... import com.liferay.mobile.screens.web.WebListener;…
パブリッククラスYourActivityは、AppCompatActivityがWebListener {... -
WebListenerのonPageLoadedメソッドを実装し。 このメソッドは、スクリーンレットがページを正常にロードしたときに呼び出されます。 どのように実装するかは、ページのロード時に何をしたいか（もしあれば）によって異なります。 たとえば、この <code>onPageLoaded実装は、成功を示すトーストメッセージを表示します。@Override public void onPageLoaded（String url）{ Toast.makeText（this、 "Page load successful！"、Toast.LENGTH_SHORT）.show（）;}
-
WebListenerのonScriptMessageHandlerメソッドを実装し。 このメソッドは、スクリーンレットの <code>WebView
送信したときに呼び出されます。 名前空間 引数はソース名前空間キーであり、 body 引数はソース名前空間本体です。 たとえば、この onScriptMessageHandler 実装は、特定のネームスペースに一致する場合、ソースネームスペース本体からデータを解析し、インテントを介してそのデータで新しいアクティビティを開始します。
@Override
public void onScriptMessageHandler（String namespace、String body）{
if（ "gallery" .equals（namespace））{
String [] allImgSrc = body.split（ "、"）;
int imgSrcPosition = Integer.parseInt（allImgSrc [allImgSrc.length-1]）;
Intent intent = new Intent（getApplicationContext（）、DetailMediaGalleryActivity.class）;
intent.putExtra（ "allImgSrc"、allImgSrc）;
intent.putExtra（ "imgSrcPosition"、imgSrcPosition）;
startActivity（intent）;
}
}
</li>
4 エラー メソッドを実装します。 このメソッドは、プロセスでエラーが発生したときに呼び出されます。 e 引数には例外が含まれ、 userAction 引数にはエラーが発生した特定のアクションが区別されます。 ほとんどの場合、これらの引数を使用してエラーを記録または表示します。 たとえば、この エラー 実装は、例外のメッセージとともにトーストメッセージを表示します。
@Override
public void error（Exception e、String userAction）{
Toast.makeText（this、 "Bad things happened：" + e.getMessage（）、Toast.LENGTH_LONG）.show（）;
}
5 WebScreenlet 参照を取得し、アクティビティまたはフラグメントクラスをそのリスナーとして設定します。 これを行うには、 com.liferay.mobile.screens.web.WebScreenlet をインポートし、 onCreate メソッドの最後に次のコードを追加します。
WebScreenletスクリーンレット=（WebScreenlet）findViewById（R.id.web_screenlet）;
screenlet.setListener（this）;
findViewById は、スクリーンレットのXMLで設定された android：id 値を参照することに注意してください。
次に、同じ WebScreenlet 参照を使用して、スクリーンレットのパラメーターを設定します。
Webスクリーンレットのパラメーターの設定
Web Screenletには、Screenletが機能するために必要なパラメーターを提供する 個のWebScreenletConfiguration および WebScreenletConfiguration.Builder オブジェクトがあります。 これらのパラメーターには、ロードするページのURLと、ページをカスタマイズするJavaScriptファイルまたはCSSファイルの場所が含まれます。 これらのパラメーターのほとんどは、 WebScreenletConfiguration.Builderのメソッドを介して設定します。
Web Screenletのパラメーターを設定するには、Screenletを含むアクティビティまたはフラグメントを初期化するメソッドで次の手順を実行します（たとえば、アクティビティの onCreate 、フラグメントの onCreateView）。 ただし、必要に応じて他の方法でこれを行うことができます。
-
WebScreenletConfiguration.Builder（<url>）（<url>はWebページのURL文字列）を使用して、WebScreenletConfiguration.Builderオブジェクトを作成します。 ページでLiferay DXP認証が必要な場合、ユーザーは Login Screenlet またはSessionContextメソッドを介してログインする必要があり、WebScreenletConfiguration.Builderコンストラクターに相対URLを提供する必要があります。 たとえば、そのようなページの完全なURLがhttp：//your.liferay.instance/web/guest/blogである場合、コンストラクターの引数は/ web / guest / blogです。 Liferay DXP認証を必要としないその他のページについては、コンストラクターに完全なURLを指定する必要があります。 -
WebScreenletConfiguration.Builderメソッドを呼び出して、必要なパラメーターを設定します。
-
WebScreenletConfiguration.Builderインスタンスのload（）メソッドを呼び出して、WebScreenletConfigurationオブジェクトを返します。 -
Web Screenletの
setWebScreenletConfigurationメソッドを使用して、WebScreenletConfigurationオブジェクトをWeb Screenletインスタンスに設定します。 -
Web Screenletインスタンスの
load（）メソッドを呼び出します。
以下は、Web Screenletインスタンスが スクリーンレットで、 WebScreenletConfiguration オブジェクトが webScreenletConfigurationであるアクティビティの onCreate（） メソッドのこれらのステップのスニペットの例です。
WebScreenletConfiguration webScreenletConfiguration =
new WebScreenletConfiguration.Builder（ "/ web / westeros-hybrid / companynews"）
.addRawCss（R.raw.portlet、 "portlet.css"）
.addLocalCss（ "gallery.css"）
.addLocalJs（ "gallery.js"）
.load（）;
screenlet.setWebScreenletConfiguration（webScreenletConfiguration）;
screenlet.load（）;
この例について注意すべき点がいくつかあります。
-
WebScreenletConfiguration.Builderコンストラクターに提供される相対URL/ web / westeros-hybrid / companynews、およびsetWebType（WebScreenletConfiguration.WebType.OTHER）呼び出しの欠如は、このWeb Screenletインスタンスが@productをロードすることを示します。認証が必要な@ページ。 -
addRawCssメソッドは、アプリのres / rawフォルダーからCSSファイルportlet.css追加します。 メソッドaddRawCssまたはaddRawJs使用して追加するファイルは、res / raw配置する必要があります（このフォルダーが存在しない場合は作成します）。 また、これらのファイルをR.raw.yourfilenameで参照する必要があることに注意してください。 たとえば、この例のportlet.cssファイルはR.raw.portlet参照されています。 -
addLocalCssおよびaddLocalJsメソッドは、ローカルファイルgallery.cssおよびgallery.jsをそれぞれ追加します。 これらの方法で追加するファイルは、アプリのアセットフォルダーの最初のレベルになければなりません。 このフォルダーは、アプリのresフォルダーと同じレベルに存在する必要があります。 存在しない場合は、その場所にアセットフォルダーを作成します。
すばらしいです\！ これで、AndroidアプリでWebスクリーンレットを使用する方法がわかりました。