Managing Network Usage
This lesson describes how to write applications that have fine-grained control over their usage of network resources. If your application performs a lot of network operations, you should provide user settings that allow users to control your app’s data habits, such as how often your app syncs data, whether to perform uploads/downloads only when on Wi-Fi, whether to use data while roaming, and so on. With these controls available to them, users are much less likely to disable your app’s access to background data when they approach their limits, because they can instead precisely control how much data your app uses.
本篇文档想你展示了,如何实际这样一个应用,应用可以对自己访问网络资源进行有效地控制。如果应用执行了很多网络操作,那么你应该给用户提供一些设置操作,比如,多久同步一次数据,是否当有wifi时执行上传下载操作等等。有了这些设置项,用户才不会对你的应用反感。也就是,给用户一些网络操作方面的设置。
For general guidelines on how to write apps that minimize the battery life impact of downloads and network connections, seeOptimizing Battery Life and Transferring Data Without Draining the Battery.
Check a Device's Network Connection
A device can have various types of network connections. This lesson focuses on using either a Wi-Fi or a mobile network connection. For the full list of possible network types, see ConnectivityManager
.
一个设备可能有不同类型的网络连接。本片文档将会聚焦于wifi和一般的移动数据连接。当然了,如果你对其他的连接类型感兴趣,可以参考ConnectivityManager
。这个类中定义了很多不同的网络连接方式。
Wi-Fi is typically faster. Also, mobile data is often metered, which can get expensive. A common strategy for apps is to only fetch large data if a Wi-Fi network is available.
wifi的速度是很快的。当英语要获取很大的数据时,首选当然是wifi了。
Before you perform network operations, it's good practice to check the state of network connectivity. Among other things, this could prevent your app from inadvertently using the wrong radio. If a network connection is unavailable, your application should respond gracefully. To check the network connection, you typically use the following classes:
在你的应用执行网络操作之前,要养成检测网络连接的好习惯。如果没有可用的网络连接,你的应用要有友好的提示信息。为了检测网络连接,你可以通过以下两种方式:所谓检测网络连接,可以理解为本地连接,在这种本地连接的基础上,是HttpUrlConnection的连接。
ConnectivityManager
: Answers queries about the state of network connectivity. It also notifies applications when network connectivity changes.
ConnectivityManager可用于检查网络连接状态。而且,当网络连接改变时,也提供同志功能。
NetworkInfo
: Describes the status of a network interface of a given type (currently either Mobile or Wi-Fi).
NetworkInfo
描述了如wifi等网络连接更多的信息。
private static final String DEBUG_TAG = "NetworkStatusExample";
...
ConnectivityManager connMgr = (ConnectivityManager)
getSystemService(Context.CONNECTIVITY_SERVICE);
NetworkInfo networkInfo = connMgr.getNetworkInfo(ConnectivityManager.TYPE_WIFI);
boolean isWifiConn = networkInfo.isConnected();
networkInfo = connMgr.getNetworkInfo(ConnectivityManager.TYPE_MOBILE);
boolean isMobileConn = networkInfo.isConnected();
Log.d(DEBUG_TAG, "Wifi connected: " + isWifiConn);
Log.d(DEBUG_TAG, "Mobile connected: " + isMobileConn);
tests network connectivity for Wi-Fi and mobile. It determines whether these network interfaces are available (that is, whether network connectivity is possible) and/or connected (that is, whether network connectivity exists and if it is possible to establish sockets and pass data):
下面的代码测试了wifi连接,也就是检测这些连接类型是否可用,也就是检查下,网络连接是否有可能建立,如果能够建立,那么再检查下网络是否已经连接。只有连接了,才能使用sockets来收发数据。
Note that you should not base decisions on whether a network is "available." You should always checkisConnected()
before performing network operations, sinceisConnected()
handles cases like flaky mobile networks, airplane mode, and restricted background data.
注意,在执行网络操作之前,一定要通过isConnected
检查下网络是否已经连接。
A more concise way of checking whether a network interface is available is as follows. The methodgetActiveNetworkInfo()
returns a NetworkInfo
instance representing the first connected network interface it can find, or null
if none of the interfaces is connected (meaning that an internet connection is not available):
一种更为精确的检查本地连接是否连接的方式如下。getActiveNetworkInfo
方法会返回一个NetworkInfo
实例。这个实例代表了getActiveNetworkInfo
方法发现的第一个连接的本地连接,如果没有本地连接时连接的话,则返回一个null。
public boolean isOnline() {
ConnectivityManager connMgr = (ConnectivityManager)
getSystemService(Context.CONNECTIVITY_SERVICE);
NetworkInfo networkInfo = connMgr.getActiveNetworkInfo();
return (networkInfo != null && networkInfo.isConnected());
}
Manage Network Usage
You can implement a preferences activity that gives users explicit control over your app's usage of network resources. For example:
技术上而言,你还需要设计一个“设置”活动,允许用户显示的通过这个活动来设置网络资源,比如:就像有些应用,刚开始运行时会检查网络连接,如果没有连接的话,会让用户进入网络界面进行设置。
- You might allow users to upload videos only when the device is connected to a Wi-Fi network.
只有在设备连接上wi-fi时,你的应用才会允许用户上传视频。
- You might sync (or not) depending on specific criteria such as network availability, time interval, and so on.
To write an app that supports network access and managing network usage, your manifest must have the right permissions and intent filters.
要想让用户能够通过你的应用来设置网络,你需要在manifest文件设置相应的权限等。这里强调了两件事情,一个是允许应用访问网络,一个是允许应用提供网络访问的控制。
- The manifest excerpted below includes the following permissions:
android.permission.INTERNET
—Allows applications to open network sockets.
android.permission.INTERNET
-允许应用打开网络套接字。这个是允许应用访问网络资源。android.permission.ACCESS_NETWORK_STATE
—Allows applications to access information about networks.
android.permission.ACCESS_NETWORK_STATE
-允许用户访问网络信息。这个是允许应用访问网络信息。
- You can declare the intent filter for the
ACTION_MANAGE_NETWORK_USAGE
action (introduced in Android 4.0) to indicate that your application defines an activity that offers options to control data usage.ACTION_MANAGE_NETWORK_USAGE
shows settings for managing the network data usage of a specific application. When your app has a settings activity that allows users to control network usage, you should declare this intent filter for that activity. In the sample application, this action is handled by the classSettingsActivity
, which displays a preferences UI to let users decide when to download a feed.
另外,还需在manifest文件的“网络设置”活动的intent过滤器中,设置ACTION_MANAGE_NETWORK_USAGE
行为。该行为会显示网络设置。在同样的应用中,这个行为会被类SettingsActivity
处理,这个类,也就是一个活动,会显示一个配置界面,允许用户声明合适下载一个种子(这些都是官方源码里的东西)。因此,如果应用要给用户提供一个可以配置的活动,就需要在活动的intent filter声明一个ACTION_MANAGE_NETWORK_USAGE
。
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.example.android.networkusage"
...> <uses-sdk android:minSdkVersion="4"
android:targetSdkVersion="14" /> <uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> <application
...>
...
<activity android:label="SettingsActivity" android:name=".SettingsActivity">
<intent-filter>
<action android:name="android.intent.action.MANAGE_NETWORK_USAGE" />
<category android:name="android.intent.category.DEFAULT" />
</intent-filter>
</activity>
</application>
</manifest>
Implement a Preferences Activity
As you can see in the manifest excerpt above, the sample app's activity SettingsActivity
has an intent filter for the ACTION_MANAGE_NETWORK_USAGE
action. SettingsActivity
is a subclass of PreferenceActivity
. It displays a preferences screen (shown in figure 1) that lets users specify the following:
正如上面manifest文件中可看到,例子源码中的SettingsActivity
活动有一个intent过滤器,该过滤器有一个ACTION_MANAGE_NETWORK_USAGE
行为。SettingsActivity
是PreferenceActivity
子类。SettingsActivity
会显示一个配置界面,这个配置界面会允许用户:
- Whether to display summaries for each XML feed entry, or just a link for each entry.
源码中的东西
- Whether to download the XML feed if any network connection is available, or only if Wi-Fi is available.
源码中的东西。
Here is SettingsActivity
. Note that it implements OnSharedPreferenceChangeListener
. When a user changes a preference, it fires onSharedPreferenceChanged()
, which sets refreshDisplay
to true. This causes the display to refresh when the user returns to the main activity:
以下是SettingsActivity的源码。注意,
SettingsActivity
实现了OnSharedPreferenceChangeListener
接口。当用户修改了一个配置项,就会触发OnSharedPreferenceChangeListener
事件。这个事件会将变量refreshDisplay
设置为true,也就是说,会在用户退回到主activity时,刷新显示界面。
public class SettingsActivity extends PreferenceActivity implements OnSharedPreferenceChangeListener { @Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState); // Loads the XML preferences file
addPreferencesFromResource(R.xml.preferences);
} @Override
protected void onResume() {
super.onResume(); // Registers a listener whenever a key changes
getPreferenceScreen().getSharedPreferences().registerOnSharedPreferenceChangeListener(this);
} @Override
protected void onPause() {
super.onPause(); // Unregisters the listener set in onResume().
// It's best practice to unregister listeners when your app isn't using them to cut down on
// unnecessary system overhead. You do this in onPause().
getPreferenceScreen().getSharedPreferences().unregisterOnSharedPreferenceChangeListener(this);
} // When the user changes the preferences selection,
// onSharedPreferenceChanged() restarts the main activity as a new
// task. Sets the the refreshDisplay flag to "true" to indicate that
// the main activity should update its display.
// The main activity queries the PreferenceManager to get the latest settings. @Override
public void onSharedPreferenceChanged(SharedPreferences sharedPreferences, String key) {
// Sets refreshDisplay to true so that when the user returns to the main
// activity, the display refreshes to reflect the new settings.
NetworkActivity.refreshDisplay = true;
}
}
Respond to Preference Changes
When the user changes preferences in the settings screen, it typically has consequences for the app's behavior. In this snippet, the app checks the preferences settings in onStart()
. if there is a match between the setting and the device's network connection (for example, if the setting is "Wi-Fi"
and the device has a Wi-Fi connection), the app downloads the feed and refreshes the display.
用户会在配置活动中改变一些配置项。如下源码显示,应用会在启动时检查旧有的配置数据,如果,比如,设置中设置了如果已经连接了wifi就会如何如何,而应用启动时,设备还真的已经连接了wifi,应用就会下载种子。
public class NetworkActivity extends Activity {
public static final String WIFI = "Wi-Fi";
public static final String ANY = "Any";
private static final String URL = "http://stackoverflow.com/feeds/tag?tagnames=android&sort=newest"; // Whether there is a Wi-Fi connection.
private static boolean wifiConnected = false;
// Whether there is a mobile connection.
private static boolean mobileConnected = false;
// Whether the display should be refreshed.
public static boolean refreshDisplay = true; // The user's current network preference setting.
public static String sPref = null; // The BroadcastReceiver that tracks network connectivity changes.
private NetworkReceiver receiver = new NetworkReceiver(); @Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState); // Registers BroadcastReceiver to track network connection changes.
IntentFilter filter = new IntentFilter(ConnectivityManager.CONNECTIVITY_ACTION);
receiver = new NetworkReceiver();
this.registerReceiver(receiver, filter);
} @Override
public void onDestroy() {
super.onDestroy();
// Unregisters BroadcastReceiver when app is destroyed.
if (receiver != null) {
this.unregisterReceiver(receiver);
}
} // Refreshes the display if the network connection and the
// pref settings allow it. @Override
public void onStart () {
super.onStart(); // Gets the user's network preference settings
SharedPreferences sharedPrefs = PreferenceManager.getDefaultSharedPreferences(this); // Retrieves a string value for the preferences. The second parameter
// is the default value to use if a preference value is not found.
sPref = sharedPrefs.getString("listPref", "Wi-Fi"); updateConnectedFlags(); if(refreshDisplay){
loadPage();
}
} // Checks the network connection and sets the wifiConnected and mobileConnected
// variables accordingly.
public void updateConnectedFlags() {
ConnectivityManager connMgr = (ConnectivityManager)
getSystemService(Context.CONNECTIVITY_SERVICE); NetworkInfo activeInfo = connMgr.getActiveNetworkInfo();
if (activeInfo != null && activeInfo.isConnected()) {
wifiConnected = activeInfo.getType() == ConnectivityManager.TYPE_WIFI;
mobileConnected = activeInfo.getType() == ConnectivityManager.TYPE_MOBILE;
} else {
wifiConnected = false;
mobileConnected = false;
}
} // Uses AsyncTask subclass to download the XML feed from stackoverflow.com.
public void loadPage() {
if (((sPref.equals(ANY)) && (wifiConnected || mobileConnected))
|| ((sPref.equals(WIFI)) && (wifiConnected))) {
// AsyncTask subclass
new DownloadXmlTask().execute(URL);
} else {
showErrorPage();
}
}
... }
Detect Connection Changes
The final piece of the puzzle is the BroadcastReceiver
subclass, NetworkReceiver
. When the device's network connection changes, NetworkReceiver
intercepts the action CONNECTIVITY_ACTION
, determines what the network connection status is, and sets the flags wifiConnected
and mobileConnected
to true/false accordingly. The upshot is that the next time the user returns to the app, the app will only download the latest feed and update the display if NetworkActivity.refreshDisplay
is set to true
.
在上面的代码中,还有一个BroadcastReceiver
子类,也就是NetworkReceiver
。当设备的网络连接发生变化时,NetworkReceiver会拦截
CONNECTIVITY_ACTION
行为,它会探知目前是wifi连接上,还是手机网连接上,然后相应的设置标志位。
Setting up a BroadcastReceiver that gets called unnecessarily can be a drain on system resources. The sample application registers the BroadcastReceiver
NetworkReceiver
in onCreate()
, and it unregisters it in onDestroy()
. This is more lightweight than declaring a <receiver>
in the manifest. When you declare a <receiver>
in the manifest, it can wake up your app at any time, even if you haven't run it for weeks. By registering and unregistering NetworkReceiver
within the main activity, you ensure that the app won't be woken up after the user leaves the app. If you do declare a <receiver>
in the manifest and you know exactly where you need it, you can use setComponentEnabledSetting()
to enable and disable it as appropriate.
例子源码中在onCreate
中注册了BroadcastReceiver
NetworkReceiver
接收器,然后在onDestroy
中卸载接收器。这可比在manifest文件中声明一个<receiver>
元素要轻量级多了。如果你在manifest文件中声明了一个<receiver>,这个元素会在任何时候唤起你的应用,即使你N年都没有运行这个应用了。通过在主要的活动中注册和反注册
NetworkReceiver
,那么当用户不运行应用的时候,也不会被什么东西唤起。
public class NetworkReceiver extends BroadcastReceiver { @Override
public void onReceive(Context context, Intent intent) {
ConnectivityManager conn = (ConnectivityManager)
context.getSystemService(Context.CONNECTIVITY_SERVICE);
NetworkInfo networkInfo = conn.getActiveNetworkInfo(); // Checks the user prefs and the network connection. Based on the result, decides whether
// to refresh the display or keep the current display.
// If the userpref is Wi-Fi only, checks to see if the device has a Wi-Fi connection.
if (WIFI.equals(sPref) && networkInfo != null && networkInfo.getType() == ConnectivityManager.TYPE_WIFI) {
// If device has its Wi-Fi connection, sets refreshDisplay
// to true. This causes the display to be refreshed when the user
// returns to the app.
refreshDisplay = true;
Toast.makeText(context, R.string.wifi_connected, Toast.LENGTH_SHORT).show(); // If the setting is ANY network and there is a network connection
// (which by process of elimination would be mobile), sets refreshDisplay to true.
} else if (ANY.equals(sPref) && networkInfo != null) {
refreshDisplay = true; // Otherwise, the app can't download content--either because there is no network
// connection (mobile or Wi-Fi), or because the pref setting is WIFI, and there
// is no Wi-Fi connection.
// Sets refreshDisplay to false.
} else {
refreshDisplay = false;
Toast.makeText(context, R.string.lost_connection, Toast.LENGTH_SHORT).show();
}
}
Managing Network Usage的更多相关文章
- Connecting to the Network
This lesson shows you how to implement a simple application that connects to the network. It explain ...
- 【Android Developers Training】 79. 连接到网络
注:本文翻译自Google官方的Android Developers Training文档,译者技术一般,由于喜爱安卓而产生了翻译的念头,纯属个人兴趣爱好. 原文链接:http://developer ...
- Android Training
Building Apps with Content Sharing Simple Data --> Intent && ActionProvider 介绍如何让应用程序共享简单 ...
- Android开发训练之第五章——Building Apps with Connectivity & the Cloud
Building Apps with Connectivity & the Cloud These classes teach you how to connect your app to t ...
- Network Load Balancing Technical Overview--reference
http://technet.microsoft.com/en-us/library/bb742455.aspx Abstract Network Load Balancing, a clusteri ...
- [转] Firewall and network filtering in libvirt
Firewall and network filtering in libvirt There are three pieces of libvirt functionality which do n ...
- Android 性能优化(5)网络优化 (1) Collecting Network Traffic Data 用Network Traffic tool :收集传输数据
Collecting Network Traffic Data 1.This lesson teaches you to Tag Network Requests 标记网络类型 Configure a ...
- http2协议翻译(转)
超文本传输协议版本 2 IETF HTTP2草案(draft-ietf-httpbis-http2-13) 摘要 本规范描述了一种优化的超文本传输协议(HTTP).HTTP/2通过引进报头字段压缩以及 ...
- Running a Remote Desktop on a Windows Azure Linux VM (远程桌面到Windows Azure Linux )-摘自网络(试了,没成功 - -!)
A complete click-by-click, step-by-step video of this article is available ...
随机推荐
- QML中实现setTimeout和setInterval
Qt的QML中,js未提供setTimeout和setInterval,可以通过下面的代码实现. Timer {id: timer} function setTimeout(cb,delayTime) ...
- 零元学Expression Blend 4 - Chapter 7 什麽?影片不再是印象中的方框框!!!看Blend 4如何把影片镶入字里
原文:零元学Expression Blend 4 - Chapter 7 什麽?影片不再是印象中的方框框!!!看Blend 4如何把影片镶入字里 本章将教大家如何在Blend 4里新增Media El ...
- mysql三种修改密码的方式
[root@MySQL ~]# mysqladmin -uroot -proot -S /data/3307/mysql.sock password '123'; 其中-p是现在的密码,passwor ...
- ORACLE 11.2.0.4 Single To Single Data Guard 安装 physical standby
[root@ORACLE ~]# su - oracle [oracle@ORACLE ~]$ sqlplus / as sysdba . 查看主库归档模式: SQL> select log_m ...
- C++没有库则寸步难行,有库则几乎可以做任何事情——Bjarne Stroustrupi
"Without a good library, most interesting tasks are hard to do in C++; but given a good library ...
- 用代码关闭冰刃(IceSword)
(*冰刃这个系统分析工具以前还没用过.这样高级的工具,用结束进程的方式就不试了.按手工关闭的流程实现.首先是通过遍历当前进程,确定冰刃进程的主窗体:然后发送WM_CLOSE关闭主窗体.当关闭对话框出现 ...
- java多线程之线程安全
线程安全和非线程安全是多线程的经典问题,非线程安全会在多个线程对同一个对象并发访问时发生. 注意1: 非线程安全的问题存在于实例变量中,如果是方法内部的私有变量,则不存在非线程安全问题. 实例变量是对 ...
- Docker+ Kubernetes已成为云计算的主流(二十五)
前言 最近正在抽时间编写k8s的相关教程,很是费时,等相关内容初步完成后,再和大家分享.对于k8s,还是上云更为简单.稳定并且节省成本,因此我们需要对主流云服务的容器服务进行了解,以便更好地应用于生产 ...
- Spring Boot:实现MyBatis分页
综合概述 想必大家都有过这样的体验,在使用Mybatis时,最头痛的就是写分页了,需要先写一个查询count的select语句,然后再写一个真正分页查询的语句,当查询条件多了之后,会发现真的不想花双倍 ...
- Fabric1.4源码解析: 链码容器启动过程
想写点东西记录一下最近看的一些Fabric源码,本文使用的是fabric1.4的版本,所以对于其他版本的fabric,内容可能会有所不同. 本文想针对Fabric中链码容器的启动过程进行源码的解析.这 ...