在本教程中，我们将探讨如何为Android平台开发一个简单的天气应用。我们将使用Java作为开发语言，利用OpenWeatherMap API获取天气数据。在此过程中，我们将介绍以下内容：
1. 准备环境
2. 获取API Key
3. 创建Android项目
4. 设计UI界面
5. 编写代码处理天气查询
6. 解析并展示天气数据
### 1. 准备环境
首先，确保你已经安装了Android Studio，你可以从这里下载并安装：https://developer.android.com/studio
### 2. 获取API Key
注册一个OpenWeatherMap帐户（https://home.openweathermap.org/users/sign_up），并获取一个API Key，以便在应用程序中访问天气数据。
### 3. 创建Android项目
启动Android Studio，创建一个新的Android项目。项目名称为“天气应用”，选择Java作为开发语言。选择一个适合的最低API级别- 低于这个级别的Android设备将无法安装此应用。
### 4. 设计UI界面
在activity_main.xml文件中编写如下XML代码：
```xml
xmlns:app="http://schemas.android.com/apk/res-auto" xmlns:tools="http://schemas.android.com/tools" android:layout_width="match_parent" android:layout_height="match_parent" android:orientation="vertical" tools:context=".MainActivity"> android:id="@+id/locationEdit" android:layout_width="match_parent" android:layout_height="wrap_content" android:hint="输入城市名称"/> android:id="@+id/queryButton" android:layout_width="wrap_content" android:layout_height="wrap_content" android:layout_gravity="center_horizontal" android:text="查询天气"/> android:id="@+id/weatherResult" android:layout_width="wrap_content" android:layout_height="wrap_content" android:layout_marginTop="16dp" android:layout_gravity="center_horizontal" />
```
这将创建一个简单的用户界面，包含一个EditText用于输入城市名称，一个Button用于查询天气，以及一个TextView用于展示查询结果。
### 5. 编写代码处理天气查询
在MainActivity.java中编写如下代码：
```java
public class MainActivity extends AppCompatActivity {
private EditText locationEdit;
private Button queryButton;
private TextView weatherResult;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
locationEdit = findViewById(R.id.locationEdit);
queryButton = findViewById(R.id.queryButton);
weatherResult = findViewById(R.id.weatherResult);
queryButton.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
String location = locationEdit.getText().toString();
queryWeather(location);
}
});
}
private void queryWeather(String location) {
// TODO: 查询天气并处理结果
}
}
```
上述代码绑定了UI控件，并在点击查询按钮时读取EditText的文本值。
接下来，在AndroidManifest.xml中添加Internet权限：
```xml
```
创建一个新的Java类：WeatherFetcher.java，并在其中编写如下代码：
```java
public class WeatherFetcher {
private static final String API_KEY = "your_api_key";
private static final String BASE_URL = "https://api.openweathermap.org/data/2.5/weather";
public interface WeatherListener {
void onSuccess(Weather weather);
void onFailure(Exception e);
}
public void fetchWeather(String location, WeatherListener listener) {
String queryUrl = BASE_URL + "?q=" + location + "&appid=" + API_KEY;
new AsyncTask
@Override
protected String doInBackground(String... params) {
try {
URL url = new URL(params[0]);
HttpURLConnection connection = (HttpURLConnection) url.openConnection();
InputStream inputStream = connection.getInputStream();
InputStreamReader reader = new InputStreamReader(inputStream);
BufferedReader bufferedReader = new BufferedReader(reader);
StringBuilder result = new StringBuilder();
String line;
while ((line = bufferedReader.readLine()) != null) {
result.append(line);
}
return result.toString();
} catch (Exception e) {
listener.onFailure(e);
return null;
}
}
@Override
protected void onPostExecute(String result) {
if (result == null) return;
try {
JSONObject jsonObject = new JSONObject(result);
Weather weather = Weather.fromJSON(jsonObject);
listener.onSuccess(weather);
} catch (JSONException e) {
listener.onFailure(e);
}
}
}.execute(queryUrl);
}
}
```
### 6. 解析并展示天气数据
创建一个新的Java类：Weather.java，并在其中编写如下代码：
```java
public class Weather {
private String city;
private String description;
public Weather(String city, String description) {
this.city = city;
this.description = description;
}
public static Weather fromJSON(JSONObject jsonObject) throws JSONException {
String city = jsonObject.getString("name");
JSONArray weatherArray = jsonObject.getJSONArray("weather");
JSONObject weatherObject = weatherArray.getJSONObject(0);
String description = weatherObject.getString("description");
return new Weather(city, description);
}
public String getCity() {
return city;
}
public String getDescription() {
return description;
}
}
```
接下来，在 MainActivity.java 的 queryWeather 方法中编写如下代码：
```java
private void queryWeather(String location) {
WeatherFetcher fetcher = new WeatherFetcher();
fetcher.fetchWeather(location, new WeatherFetcher.WeatherListener() {
@Override
public void onSuccess(Weather weather) {
runOnUiThread(() -> weatherResult.setText(weather.getCity() + " 的天气为：" + weather.getDescription()));
}
@Override
public void onFailure(Exception e) {
runOnUiThread(() -> Toast.makeText(MainActivity.this, "查询错误：" + e.getMessage(), Toast.LENGTH_SHORT).show());
}
});
}
```
这样，当点击查询按钮时，应用程序将会发送请求获取天气数据并在UI上展示。
至此，你已经完成了一个简单的天气API示例。在实际项目中，可以进行UI和功能优化，如添加城市选择器、定位获取当前城市、动态背景图片等。
