HarmonyOS手表Demo—定位套件之二

作者：木棉花小蓝 2022-04-14 11:35:01系统 OpenHarmony 在正式开发应用前，位套我们需要在Gradle文件中设置AppGallery Connect的位套Gradle插件以及AppGallery Connect SDK基础包，以及将Location SDK集成到开发环境中，位套这些都是位套上期内容中未完成的步骤。

​​想了解更多内容，位套请访问：​​

​​51CTO和华为官方合作共建的位套鸿蒙技术社区​​

​​https://ost.51cto.com​​

正文

在上期的内容中，我们完成了开发定位服务Demo的位套基本准备。而在这期内容中，位套笔者会将剩下的位套开发工作做完。

为项目集成SDK

在正式开发应用前，位套我们需要在Gradle文件中设置AppGallery Connect的位套Gradle插件以及AppGallery Connect SDK基础包，以及将Location SDK集成到开发环境中，位套这些都是位套上期内容中未完成的步骤。

首先，位套我们需要下载agconnect-services.json文件。位套

下载完成后，将此agconnect-services.json文件复制到剪切板中，然后打开DevEco Studio中的项目，再打开entry>src，将agconnect-services.json文件粘贴到src的目录中。

接着，打开项目级的build.gradle：

并在dependencies中添加相关代码：

dependencies { 
...
classpath 'com.huawei.agconnect:agcp-harmony:1.0.0.300'
}

之后，打开模块级的build.gradle。

首先，在dependencies中添加相关代码：

dependencies { 
... 
implementation 'com.huawei.hms:location-harmony:6.3.0.300' 
implementation 'com.huawei.agconnect:agconnect-core-harmony:1.3.0.300'
}

之后，在模块级build.gradle文件的顶部添加相关代码。

apply plugin: 'com.huawei.ohos.hap'
...
apply plugin: 'com.huawei.agconnect' //添加此行代码
...

完成上述操作后，点击右上角的sync now，即可完成脚本文件的同步。

添加应用权限

打开entry>src>main>config.json，在module模块中添加获取网络状态的权限，定位权限以及后台定位权限：

"module": {   
...
"reqPermissions": [
{ 
"name": "ohos.permission.GET_NETWORK_INFO",
"reason": "Allows programs to obtain network information status." 
},
{ 
"name": "ohos.permission.LOCATION",
"reason": "Allows applications to obtain location information when running in the foreground."
},
{ 
"name": "ohos.permission.LOCATION_IN_BACKGROUND",
"reason": "Allows applications to obtain location information when running in the background."
}
],
...
}

完成上述操作后，点击右上角的sync now，即可完成脚本文件的同步。

配置混淆脚本

编译APP前，我们需要配置混淆配置文件，这样可以避免混淆SDK导致功能异常。

打开entry>src>proguard-rules.pro，加入排除HMS Core SDK的混淆配置。

-ignorewarnings
-repackageclasses
-keepattributes *Annotation*
-keepattributes Exceptions
-keepattributes InnerClasses
-keepattributes Signature
-keep public class com.huawei.hms.location.harmony.* {  *;}
-keep public class com.huawei.hms.location.harmony.base.* {  *;}
-keep class com.huawei.hmf.tasks.* { *;}

设置交互逻辑

完成前文的基础操作后，我们便可以开始写入定位服务Demo的交互逻辑了。

第一个要做的是一完成页面跳转，即从MainAbilitySlice跳转至GetLastLocationAbilitySlice。前者用于提供Demo的初始界面，类似于一个屏幕保护壁纸，而后者则提供带有定位业务的界面，它是这个Demo的核心页面。

打开entry>src>main>Java>com.example.location_hms>slice>MainAbilitySlice，在onStart回调中加入如下代码，实现不同Page Ability间页面导航的功能。

@Override
public void onStart(Intent intent) { 
...
Button button1=(Button) findComponentById(ResourceTable.Id_bn1);  //获取Button组件对象
button1.setClickedListener(new Component.ClickedListener() {              //为此Button设置点击监听器
@Override
public void onClick(Component component) {           //设置Click事件
Intent intent1=new Intent();           //创建Intent对象
Operation operation=new Intent.OperationBuilder()    //创建Operation对象
.withDeviceId("")
.withBundleName("com.example.location_hms")
.withAbilityName("com.example.location_hms.GetLastLocationAbility")    //设置需要跳转的目标Page Ability
.build();
intent1.setOperation(operation);   //设置Intent对象的operation属性
startAbility(intent1);   //添加启动Ability的指令
}
});
}

第二个需要实践的是—在代码中动态申请相关定位权限。

在前面的步骤中，我们已经将定位权限和后台定位权限(即“ohos.permission.LOCATION ”和“ohos.permission.LOCATION_IN_BACKGROUND”)添加到config.json中了，但这两个权限属于敏感权限，需要用户手动进行动态申请。

所以，我们新建一个AbilitySlice，并将其命名为RequestAbilitySlice。

创建完成后，在RequestAbilitySlice中添加如下代码，以创建一个动态申请相关定位权限的线程。

public class RequestAbilitySlice extends AbilitySlice { 
private static final String TAG = "RequestAbilitySlice";
private static final int DOMAIN = 0xD001100;
private static final int REQUEST_CODE = 0x1001;
private static Map<String, HiLogLabel> logLabelMap = new HashMap<>();
public FusedLocationClient fusedLocationClient;
@Override
protected void onStart(Intent intent) { 
super.onStart(intent);
fusedLocationClient = new FusedLocationClient(this);
}
@Override
protected void onActive() { 
super.onActive();
}
public void checkSelfPermission() { 
if (verifySelfPermission("ohos.permission.LOCATION") != IBundleManager.PERMISSION_GRANTED) { 
printLog(HiLog.INFO, TAG, "Self: LOCATION permission not granted!");
if (canRequestPermission("ohos.permission.LOCATION")) { 
printLog(HiLog.INFO, TAG, "Self: can request permission here");
requestPermissionsFromUser(
new String[]{ "ohos.permission.LOCATION"}, REQUEST_CODE);
} else { 
printLog(HiLog.WARN, TAG, "Self: enter settings to set permission");
}
} else { 
printLog(HiLog.INFO, TAG, "Self: LOCATION permission granted!");
}

if (verifySelfPermission("ohos.permission.LOCATION_IN_BACKGROUND") != IBundleManager.PERMISSION_GRANTED) { 
printLog(HiLog.INFO, TAG, "Self: LOCATION_IN_BACKGROUND permission not granted!");
if (canRequestPermission("ohos.permission.LOCATION_IN_BACKGROUND")) { 
printLog(HiLog.INFO, TAG, "Self: can request permission here");
requestPermissionsFromUser(
new String[]{ "ohos.permission.LOCATION_IN_BACKGROUND"}, REQUEST_CODE);
} else { 
printLog(HiLog.WARN, TAG, "Self: enter settings to set permission");
}
} else { 
printLog(HiLog.INFO, TAG, "Self: LOCATION_IN_BACKGROUND permission granted!");
}
}
public void printLog(int level, String tag, String message) { 
HiLogLabel hiLogLabel = getLogLabel(tag);
switch (level) { 
case HiLog.INFO:
HiLog.info(hiLogLabel, message);
break;
case HiLog.WARN:
HiLog.warn(hiLogLabel, message);
break;
case HiLog.ERROR:
HiLog.error(hiLogLabel, message);
break;
default:
HiLog.debug(hiLogLabel, message);
break;
}
}
private HiLogLabel getLogLabel(String tag) { 
HiLogLabel label;
String tagStr;

if (tag == null || tag.isEmpty()) { 
tagStr = "TAG";
} else { 
tagStr = tag;
}
if (logLabelMap.containsKey(tagStr)) { 
label = logLabelMap.getOrDefault(tagStr, new HiLogLabel(HiLog.LOG_APP, DOMAIN, "TAG"));
} else { 
label = new HiLogLabel(HiLog.LOG_APP, DOMAIN, tagStr);
logLabelMap.put(tagStr, label);
}
return label;
}
public void printScreenLog(Text showLocation, String msg) { 
StringBuilder outputBuilder = new StringBuilder();
SimpleDateFormat formatter = new SimpleDateFormat("HH:mm:ss");
Date curDate = new Date(System.currentTimeMillis());
String dateStr = formatter.format(curDate);
outputBuilder.append(dateStr);
outputBuilder.append(" ");
outputBuilder.append(msg);
outputBuilder.append(System.lineSeparator());
showLocation.setMultipleLine(true);
showLocation.append(outputBuilder.toString());
}    
}

并且，我们希望打开应用时，系统就能推送关于申请权限的消息，故我们需要在MainAbility中进行相关设置。

打开entry>src>main>Java>com.example.location_hms>MainAbility，添加如下代码：

public class MainAbility extends Ability { 
private static final int REQUEST_CODE = 0x1000;
private static final int DOMAIN = 0xD001100;
private HiLogLabel hiLogLabel = new HiLogLabel(HiLog.LOG_APP, DOMAIN, "TAG");
@Override
public void onStart(Intent intent) { 
super.onStart(intent);
super.setMainRoute(MainAbilitySlice.class.getName());
String[] strings = { "ohos.permission.LOCATION", "ohos.permission.LOCATION_IN_BACKGROUND"};
requestPermissionsFromUser(strings, REQUEST_CODE);
}
@Override
public void onRequestPermissionsFromUserResult(int requestCode, String[] permissions, int[] grantResults) { 
super.onRequestPermissionsFromUserResult(requestCode, permissions, grantResults);
HiLog.info(hiLogLabel, "MainAbility onRequestPermissionsFromUserResult :" + Arrays.toString(grantResults));
if (requestCode == REQUEST_CODE) { 
HiLog.info(hiLogLabel, "MainAbility request permission success.");
}
}
}

第三个需要做的则是一在GetLocationAbilitySlice中写入的就是定位服务的功能逻辑了。

我们在之前创建了一个用于动态申请相关权限的RequestAbilitySlice，不过它只是作为一个基类Slice，相当于一个模板，在Demo中并不被当作具体页面向用户展示。而这个RequestAbilitySlice的用处则是被GetLastLocationAbilitySlice所继承，这样做不仅能将两种不同作用的代码分隔开来，以免混淆，而且想在这个Demo中扩展其他定位功能时，也可以让新建的AbilitySlice直接继承这个基类slice，避免重复写同一种代码。

打开GetLastLocationAbilitySlice，将它extend的对象改为RequestAbilitySlice，并加入相应代码：

public class GetLastLocationAbilitySlice extends RequestAbilitySlice implements Component.ClickedListener {    //继承RequestAbilitySlice
private static final String TAG = "GetLastLocationSlice";
private Text showLocation;
@Override
public void onStart(Intent intent) { 
super.onStart(intent);
super.setUIContent(ResourceTable.Layout_ability_get_last_location);
checkSelfPermission();
findComponentById(ResourceTable.Id_btn_getLastLocationWithAddress).setClickedListener(this);
showLocation = (Text) findComponentById(ResourceTable.Id_show_location);  //获取文本组件的对象
}
@Override
public void onClick(Component component) { 
switch (component.getId()) { 
case ResourceTable.Id_btn_getLastLocationWithAddress:
getLastLocationWithAddress();
break;
default:
break;
}
} 
private void getLastLocationWithAddress() { 
fusedLocationClient.getLastLocationWithAddress(buildLocationRequest())    //获取fusedLocationClient对象
.addOnSuccessListener(location -> { 
if (null == location) { 
printLog(HiLog.INFO, TAG, "[new]getLastLocationWithAddress onSuccess: hwLocation is null");
return;
}
String result = "[--已获得您的位置--]" +" "
+"[国家-省份-城市-城区-具体位置]:"
+ location.getCountryName() + ">"
+ location.getState() + ">" + location.getCity() + ">"
+ location.getCounty() + ">" + location.getFeatureName()+"";   //定义需要输出到文本组件的字符串（获取位置成功时）
printLog(HiLog.INFO, TAG, result);
printScreenLog(showLocation, result);
})
.addOnFailureListener(e -> { 
printLog(HiLog.INFO, TAG, "无法获取您的位置 " + e.getMessage());
printScreenLog(showLocation, "无法获取您的位置 " + e.getMessage());  //定义需要输出到文本组件的字符串（获取位置失败时）
});
}
private LocationRequest buildLocationRequest() { 
LocationRequest locationRequest = new LocationRequest();
locationRequest.setNeedAddress(true);
locationRequest.setLanguage("zh");
locationRequest.setCountryCode("CN");
return locationRequest;
}
}

完成上述操作后，定位套件的制作就大功告成了。

效果图如下：

结尾

本期的分享到这里就结束了。

​​想了解更多内容，请访问：​​

​​51CTO和华为官方合作共建的鸿蒙技术社区​​

​​https://ost.51cto.com​​

责任编辑：jianghua 来源： 鸿蒙社区 HarmonyOS手表Demo操作系统

(责任编辑：焦点)