Android小插件

2023-12-14 21:39| 来源: 网络整理| 查看: 265

前言

最近项目中需要实现一个展示天气信息的功能，就去搜索相关的天气API接口，拿到接口后本地进行解析展示即可。在搜索的过程中，发现了一个很好用的天气插件，无需自己请求天气API以及布局天气信息UI，真是省时、省力，更重要的是，还是免费的！免费的！免费的！（开心o(￣▽￣)ブ）那么接下来我们就开始认识一下这个插件吧！

一、介绍

和风天气开发平台 https://dev.qweather.com/

和风天气开发平台官网首页

这个平台提供了移动端的天气数据SDK、Web端的天气数据Web API以及免费的天气插件，可以在任意网站、APP中使用，几乎不需要开发。我们今天就来试试Android上天气插件的使用。

Android天气插件

二、准备工作 1、生成密钥key和下载jar包。

在这里插入图片描述

2、工程配置

（1）将jar包添加到项目的libs目录下，右击jar包选择Add as library。

在这里插入图片描述

（2）项目的AndroidManifeist.xml文件中添加权限注意：如果添加了位置相关的权限，Android6.0以上仍然需要动态申请该位置权限。

（3）项目级别的build.gradle文件中，引用相关库。

//引用库 implementation 'com.squareup.okhttp3:okhttp:3.9.0' implementation 'com.google.code.gson:gson:2.6.2'

（4）如果要开启混淆，则还需要在混淆文件proguard-rules.pro中添加以下规则

#排除OKHTTP -dontwarn com.squareup.** -dontwarn okio.** -keep public class org.codehaus.* { *; } -keep public class java.nio.* { *; } #排除sdk -keep public class com.qweather.plugin.bean.** { *; } -keep public class com.qweather.plugin.view.** { *; }

说明：我在创建工程的时候，使用的是Android Studio4.2.1版本，工程创建成功后，gradle.properties中只有如图中的两行，这导致我在调用插件代码的运行APP时候，会报找不到如下图“Caused by: java.lang.ClassNotFoundException: Didn’t find class “android.support.v4.app.ActivityCompat” on path:…”的错误。

在这里插入图片描述

后面一顿操作，发现需要在gradle.properties文件中添加下面一句话就不会报错了，看这个注释的意思大概就是“自动将第三方库转换以使用AndroidX”，至此终于可以安心使用插件了。在这里插入图片描述

三、SDK使用 1、初始化 /* * 初始化 * @param key 用户的KEY (密钥key) * @param location 城市信息，若不传或为空则调用Android源生定位 * * 上述location属性，如不传递location，则采用android原生定位， * 需开启android.permission.ACCESSCOARSELOCATION 和 * android.permission.ACCESSFINELOCATION权限 */ QWeatherConfig.init("key","location"); QWeatherConfig.init("key"); 2、布局及显示天气插件布局一共有4种，分别为横向布局、左1右2横向布局、右1左2横向布局，以及纵向布局。（1）横向布局 QWeatherConfig.init("密钥key"); HorizonView horizonView = findViewById(R.id.horizon_View); //设置控件显示默认的背景图片 llView.setDefaultBack(true); //添加地址文字描述，第一个参数为文字大小，单位：sp ，第二个参数为文字颜色，默认白色 horizonView.addLocation(14, Color.WHITE); //添加预警图标，参数为图标大小，单位：dp horizonView.addAlarmIcon(14); //添加预警文字 horizonView.addAlarmTxt(14); //添加温度描述 horizonView.addTemp(14, Color.WHITE); //添加天气图标 horizonView.addWeatherIcon(14); //添加天气描述 horizonView.addCond(14, Color.WHITE); //添加风向图标 horizonView.addWindIcon(14); //添加风力描述 horizonView.addWind(14, Color.WHITE); //添加文字：AQI horizonView.addAqiText(14, Color.WHITE); //添加空气质量描述 horizonView.addAqiQlty(14); //添加空气质量数值描述 horizonView.addAqiNum(14); //添加降雨图标 horizonView.addRainIcon(14); //添加降雨描述 horizonView.addRainDetail(14, Color.WHITE); //设置控件的对齐方式，默认居中 horizonView.setViewGravity(HeContent.GRAVITY_CENTER); //设置控件的内边距，默认为0 horizonView.setViewPadding(10, 10, 10, 10); //显示控件 horizonView.show();

横向布局显示

（2）左1右2横向布局 QWeatherConfig.init("密钥key"); LeftLargeView llView = findViewById(R.id.ll_view); //获取左侧大布局 LinearLayout leftLayout = llView.getLeftLayout(); //获取右上布局 LinearLayout rightTopLayout = llView.getRightTopLayout(); //获取右下布局 LinearLayout rightBottomLayout = llView.getRightBottomLayout(); //设置控件显示默认的背景图片 llView.setDefaultBack(true); //添加温度描述到左侧大布局 //第一个参数为需要加入的布局 //第二个参数为文字大小，单位：sp //第三个参数为文字颜色，默认白色 llView.addTemp(leftLayout, 40, Color.WHITE); //添加温度图标到右上布局，第二个参数为图标宽高（宽高1：1，单位：dp） llView.addWeatherIcon(rightTopLayout, 14); //添加天气描述到右上布局 llView.addCond(rightTopLayout, 14, Color.WHITE); //添加预警图标到右上布局 llView.addAlarmIcon(rightTopLayout, 14); //添加预警描述到右上布局 llView.addAlarmTxt(rightTopLayout, 14); //添加文字AQI到右上布局 llView.addAqiText(rightTopLayout, 14); //添加空气质量到右上布局 llView.addAqiQlty(rightTopLayout, 14); //添加空气质量数值到右上布局 llView.addAqiNum(rightTopLayout, 14); //添加地址信息到右上布局 llView.addLocation(rightTopLayout, 14, Color.WHITE); //添加风向图标到右下布局 llView.addWindIcon(rightBottomLayout, 14); //添加风力描述到右下布局 llView.addWind(rightBottomLayout, 14, Color.WHITE); //添加降雨图标到右下布局 llView.addRainIcon(rightBottomLayout, 14); //添加降雨描述到右下布局 llView.addRainDetail(rightBottomLayout, 14, Color.WHITE); //设置控件的对齐方式，默认居中 llView.setViewGravity(HeContent.GRAVITY_LEFT); //显示布局 llView.show();

在这里插入图片描述

（3）右1左2横向布局 QWeatherConfig.init("密钥key"); RightLargeView rlView = findViewById(R.id.rl_view); //获取右侧大布局 LinearLayout rightLayout = rlView.getRightLayout(); //获取左上布局 LinearLayout leftTopLayout = rlView.getLeftTopLayout(); //获取左下布局 LinearLayout leftBottomLayout = rlView.getLeftBottomLayout(); //取消默认背景 rlView.setDefaultBack(false); //设置布局的背景圆角角度，颜色，边框宽度边框颜色 rlView.setStroke(0, Color.GRAY, 1, Color.WHITE); //添加地址文字描述到左上布局 // 第一个参数为需要加入的布局， // 第二个参数文字大小，单位：sp ， // 第三个参数为文字颜色，默认白色 rlView.addLocation(leftTopLayout, 14, Color.WHITE); //添加文字：AQI rlView.addAqiText(leftTopLayout, 14); //添加空气质量描述 rlView.addAqiQlty(leftTopLayout, 14); //添加空气质量数值描述 rlView.addAqiNum(leftTopLayout, 14); //添加预警图标，参数为图标大小，单位：dp rlView.addAlarmIcon(leftTopLayout, 14); //添加预警文字 rlView.addAlarmTxt(leftTopLayout, 14); //添加天气图标 rlView.addWeatherIcon(leftTopLayout, 14); //添加到左下布局 //添加降雨图标 rlView.addRainIcon(leftBottomLayout, 14); //添加降雨描述 rlView.addRainDetail(leftBottomLayout, 14, Color.WHITE); //添加风向图标 rlView.addWindIcon(leftBottomLayout, 14); //添加风力描述 rlView.addWind(leftBottomLayout, 14, Color.WHITE); //添加天气描述 rlView.addCond(leftBottomLayout, 14, Color.WHITE); //添加温度描述 rlView.addTemp(rightLayout, 40, Color.WHITE); //设置控件的对齐方式，默认居中 rlView.setViewGravity(HeContent.GRAVITY_RIGHT); rlView.show();

在这里插入图片描述

（4）纵向布局 ``` ```c QWeatherConfig.init("密钥key"); VerticalView verticalView = findViewById(R.id.vertical_view); //默认布局背景 verticalView.setDefaultBack(true); verticalView.addLocation(14, Color.WHITE); verticalView.addTemp(14, Color.WHITE); verticalView.addWeatherIcon(14); verticalView.addCond(14, Color.WHITE); verticalView.addWindIcon(14); verticalView.addWind(14, Color.WHITE); verticalView.addAqiText(14, Color.WHITE); verticalView.addAqiQlty(14); verticalView.addAqiNum(14); verticalView.addAlarmIcon(14); verticalView.addAlarmTxt(14); verticalView.addRainIcon(14); verticalView.addRainDetail(14, Color.WHITE); verticalView.show();

在这里插入图片描述

3、高级设置（1）设置背景颜色

控件默认背景是根据天气变化展示不同的背景图片

上面“右1左2横向布局”就是自定义的背景，如下面部分代码

//取消默认背景 rlView.setDefaultBack(false); //设置布局的背景圆角角度，颜色，边框宽度边框颜色 rlView.setStroke(0, Color.GRAY, 1, Color.WHITE); （2）链接到H5

如需点击控件跳转到天气详情H5界面需要在AndroidManifest.xml配置如下代码：

这里有个问题需要注意下，如果不想链接到H5界面，因为控件内部已经绑定了点击事件，此时如果不小心点击到控件，程序就会闪退。

（3）使用天气悬浮控件 QWeatherConfig.init("密钥key"); //初始化悬浮控件 SuspendView suspendView = new SuspendView(this); //显示悬浮控件 suspendView.show();

在这里插入图片描述

（4）替换天气图标

1、在文件目录app/src/main下创建资源文件夹assets 2、在app/src/main/assets文件夹放入文件名对应天气代码的图标，文件名：白天是天气代码+d，晚上是天气代码+n后缀为.png，例如：100d.png，100n.png，请参考天气图标 3、在初始化的时候调用下列方法

//替换天气图标为本地图标 QWeatherConfig.changeWeatherIcon();

【本文地址】

公司简介

联系我们