89 lines
3.2 KiB
XML
89 lines
3.2 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<!--
|
|
Copyright 2013 The Android Open Source Project
|
|
|
|
Licensed under the Apache License, Version 2.0 (the "License");
|
|
you may not use this file except in compliance with the License.
|
|
You may obtain a copy of the License at
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
See the License for the specific language governing permissions and
|
|
limitations under the License.
|
|
-->
|
|
<sample>
|
|
<name>NetworkConnect</name>
|
|
<group>Connectivity</group>
|
|
<package>com.example.android.networkconnect</package>
|
|
|
|
|
|
|
|
<!-- change minSdk if needed-->
|
|
<minSdk>14</minSdk>
|
|
|
|
|
|
<strings>
|
|
<intro>
|
|
<![CDATA[
|
|
This sample demonstrates how to connect to the network and fetch raw HTML using
|
|
HttpsURLConnection. AsyncTask is used to perform the fetch on a background thread.
|
|
]]>
|
|
</intro>
|
|
</strings>
|
|
|
|
<template src="base"/>
|
|
|
|
<metadata>
|
|
<status>PUBLISHED</status>
|
|
<categories>Connectivity</categories>
|
|
<technologies>Android</technologies>
|
|
<languages>Java</languages>
|
|
<solutions>Mobile</solutions>
|
|
<level>INTERMEDIATE</level>
|
|
<icon>screenshots/icon-web.png</icon>
|
|
<screenshots>
|
|
<img>screenshots/main.png</img>
|
|
</screenshots>
|
|
<api_refs>
|
|
<android>android.os.AsyncTask</android>
|
|
<android>android.net.ConnectivityManager</android>
|
|
<android>android.net.NetworkInfo</android>
|
|
</api_refs>
|
|
|
|
<description>
|
|
<![CDATA[
|
|
This sample demonstrates how to connect to the network and fetch raw HTML using
|
|
HttpsURLConnection. AsyncTask is used to perform the fetch on a background thread.
|
|
]]>
|
|
</description>
|
|
|
|
<intro>
|
|
<![CDATA[
|
|
This sample demonstrates how to connect to the network and fetch raw HTML using
|
|
[`HttpsURLConnection`][4]. Since API 11, it is required by default that all network
|
|
operations run on a background thread in order to avoid hanging on the UI thread. Only
|
|
when the network response is ready should the work return to the main thread to update
|
|
the UI. An [`AsyncTask`][3] is a viable background task manager that is used to perform
|
|
the network operation and return to the UI thread upon completion.
|
|
|
|
The sample also utilizes the [`ConnectivityManager`][1] to determine if you have
|
|
a network connection, and if so, what type of connection it is.
|
|
|
|
Using an [`AsyncTaskLoader`][6] or an [`IntentService`][5] are two common alternatives
|
|
for managing longer running background work.
|
|
|
|
[1]: https://developer.android.com/reference/android/net/ConnectivityManager.html
|
|
[2]: https://developer.android.com/reference/android/net/NetworkInfo.html
|
|
[3]: https://developer.android.com/reference/android/os/AsyncTask.html
|
|
[4]: https://developer.android.com/reference/javax/net/ssl/HttpsURLConnection.html
|
|
[5]: https://developer.android.com/reference/android/app/IntentService.html
|
|
[6]: https://developer.android.com/reference/android/content/AsyncTaskLoader.html
|
|
]]>
|
|
</intro>
|
|
</metadata>
|
|
|
|
</sample>
|