Android在WebView上构建Web应用程序

时间:2024-07-27 08:04:13

原文链接:http://developer.android.com/guide/webapps/webview.html

reference:http://developer.android.com/reference/android/webkit/WebView.html

假设你想实现一个Web应用(或不过一个网页)作为你应用中的一部分,你能够使用WebView来实现它。WebView是Android的View类的扩展,它同意你显示一个网页作为Activity布局的一部分。它不包括成熟的浏览器的一些功能,比如导航控制或输入栏。默认情况下,WebView显示一个网页。

        一个使用WebView的非常普遍的场合是当你想要在应用中提供须要时常更新的信息时,比如用户协议或用户手冊。在Android应用其中,你能创建一个Activity它包括一个WebView,然后使用它你能够显示网上提供的文档。

        还有一个使用WebView的场合是:假如你的应用总是须要网络链接来获取数据并提供给用户,比如电子邮件。这时候,你能发如今应用中创建一个WebView并使用网页来显示用户数据,比运行网络请求,解析数据然后再渲染到Android布局其中更加方便。你仅仅须要依据Android设备设计网页,然后在应用其中实现一个WebView然后加载刚刚设计的网页。

        这篇文档会教你怎样開始学习WebView并实现一些其它功能,比如页面导航和绑定JavaScript到网页其中。

在应用中加入一个WebView

想加入一个WebView到应用其中,你仅仅须要包括WebView标签到你的Activity布局文件其中。比如,以下是一个WebView填充满屏幕的布局

<?xml version="1.0" encoding="utf-8"?>
<WebView xmlns:android=http://schemas.android.com/apk/res/android
android:id="@+id/webview"
android:layout_width="fill_parent"
android:layout_height="fill_parent"/>

在WebView中加载网页,能够使用loadUrl()方法,比如

WebView myWebView = (WebView) findViewById(R.id.webview);
myWebView.loadUrl("http://www.baidu.com");

这段代码执行之前,你须要接入到因特网中。你仅须要加入因特网权限到你的Manifest文件其中。

<uses-permission android:name="android.permission.INTERNET" />

这些是显示一个网页的基本知识。

在WebView中使用JavaScript

假设你想要加载的网页实现了JavaScript,你必须在WebView中开启JavaScript功能。当JavaScript实用时,你还能够再你的应用代码和JavaScript代码之间创建接口。

开启JavaScript

在WebView中JavaScript默认是不开启的。你能够通过WebSettings加入到WebView其中开启它。你能够使用getSettings()方法获得WebSettings,然后使用setJavaScriptEnabled()来开启它。 比如:

WebView myWebView = (WebView) findViewById(R.id.webview);
WebSettings webSettings = myWebView.getSettings();
webSettings.setJavaScriptEnabled(true);

在WebSettings中你能够发现非常多实用的功能。比如,假设你使用WebView开发一个网络应用,你能够使用setUserAgentString()方法定义一个自己定义用户代理字符串,后面能够查询网页中的自己定义用户代理,辨别当前请求网页的是不是你的Android应用。

绑定JavaScript代码到Android源代码

当在应用其中使用WebView创建网络应用的时候,你能够在JavaScript和Android源代码之间创建一个接口,比如,你的JavaScript代码能够调用Android中定义的方法来显示一个对话框,而不适用JavaScript的alert()方法。

比如你能够在应用其中加入下面的类:

public class JavaScriptInterface {
Context mContext;
/** Instantiate the interface and set the context */
JavaScriptInterface(Context c) {
mContext = c;
}
/** Show a toast from the web page */
public void showToast(String toast) {
Toast.makeText(mContext, toast, Toast.LENGTH_SHORT).show();
}
}

在这个样例中,JavaScriptInterface类使用showToast()方法创建Toast消息。

你能够绑定这个类到JavaScript其中并在WebView其中使用addJavaScriptInterface()方法执行并创建接口的名称为Android。

WebView webView = (WebView) findViewById(R.id.webview);
webView.addJavascriptInterface(new JavaScriptInterface(this), "Android");

这段代码会创建一个名称为“Android”的JavaScript接口并执行在WebView其中。在这里,你的Web应用会接入到JavaScriptInterface类。比如,以下为Html何JavaScript代码,它会在用户点击button的时候使用新的接口创建一个Toast消息。

<input type="button" value="Say hello" onClick="showAndroidToast('Hello Android!')" />
<script type="text/javascript">
function showAndroidToast(toast) {
Android.showToast(toast);
}
</script>

你不须要初始化从JavaScript其中初始化Android接口。WebView会自己主动的让他能够使用在网页其中。因此,当点击按钮的时候showAndroidToast()方法会使用Android接口调用JavaScriptInterface.showToast()方法。

备注:在JavaScript中绑定的对象会执行在还有一个线程,它和创建它的线程是不同的线程。

注意点:使用java.lang.String) addJavaScriptInterface()同意JavaScript来控制Android应用。这是一个很实用和危急的。当在WebView其中的HTML是不能信任的(比如,HTML中的一些内容是由不认识的人或线程来提供),攻击者能够任意控制运行在client的HTML代码。相同的,除了你须要你写的HTML或JavaScript在WebView其中呈现出来,你不应该使用java.lang.String) addJavaScriptInterface()方法。你也不能同意用户在WebView中操纵除了自己外的别的网页(相反,你应该让用户调用默认的浏览器来打开外部的连接--一般,用户的网页浏览器会打开全部的URL链接,因此仅仅有当操纵的网页跟下部分描写叙述的一样)。

处理页面导航

当用户在你的WebView中点击一个链接时,对于Android来说默认的动作时启动一个应用程序捕捉它。通常,默认的网页浏览器会打开而且加载目标URL。然而,你能够在WebView中重写该动作,把该链接在你的WebView中打开。你还能够让用户自己处理历史的回退和前进功能。

打开用户点击的链接,只在WebView中提供WebViewClient就可以,使用setWebViewClient()方法。比如:

WebView myWebView = (WebView) findViewById(R.id.webview);
myWebView.setWebViewClient(new WebViewClient());

完毕,如今用户点击的全部链接都会在WebView中打开。假设你想要在点击链接并加载网页的时候做很多其它的操作,请创建自己的WebViewClient 并重写java.lang.String) shouldOverrideUrlLoading()方法。比如:

private class MyWebViewClient extends WebViewClient {
@Override
public boolean shouldOverrideUrlLoading(WebView view, String url) {
if (Uri.parse(url).getHost().equals("www.example.com")) {
//这是我的网页,所以不要重写,让我的WebView加载它
return false;
}
// 假设不是我的网页,则启动另外的Activity来处理该URL
Intent intent = new Intent(Intent.ACTION_VIEW, Uri.parse(url));
startActivity(intent);
return true;
}
}

然后给WebView创建一个WebViewClient的实例。

WebView myWebView = (WebView) findViewById(R.id.webview);
myWebView.setWebViewClient(new MyWebViewClient());

如今当用户点击一个链接,系统会调用java.lang.String) shouldOverrideUrlLoading() , 它会辨别URL主机是否要匹配指定的域名(就像我们上面列举的一样)。假设它不能匹配,则该方法返回false,一个Intent会创建并启动默认的Activity来处理该URL(它一般解析为用户的默认浏览器)。

操作网页历史

当你的WebView重写URL的加载,它会自己主动累积訪问过的网页历史。你能够使用goBack()方法和goForward()方法操纵回退和向前功能。 比如,以下是Activity使用返回button操作“回退”功能。

@Override
public boolean onKeyDown(int keyCode, KeyEvent event) {
// Check if the key event was the Back button and if there's history
if ((keyCode == KeyEvent.KEYCODE_BACK) && myWebView.canGoBack() {
myWebView.goBack();
return true;
}
// If it wasn't the Back key or there's no web page history, bubble up to the default
// system behavior (probably exit the activity)
return super.onKeyDown(keyCode, event);
}

假设有网页历史则canGoBack()方法返回True,相同的,你能够使用canGoForward()来检查是否有“前进”历史。假设你不运行这个检查,当用户到达历史的尽头的时候,goBack()和goForward()什么都不做。