【木棉花】HarmonyOS手表Demo——定位套件（下）原创精华

木棉花_小蓝

发布于 2022-4-11 15:25

浏览

3收藏

最新收录于

HarmonyOS Java (Abandoned)

查看专栏

前言

上期内容详见https://ost.51cto.com/posts/10995

正文

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

为项目集成SDK

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

首先，我们需要下载agconnect-services.json文件；【木棉花】HarmonyOS手表Demo——定位套件（下）-鸿蒙开发者社区

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

【木棉花】HarmonyOS手表Demo——定位套件（下）-鸿蒙开发者社区接着，打开项目级的build.gradle：

【木棉花】HarmonyOS手表Demo——定位套件（下）-鸿蒙开发者社区

并在dependencies中添加相关代码：

    dependencies {
          ...

        classpath 'com.huawei.agconnect:agcp-harmony:1.0.0.300'

    }

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

【木棉花】HarmonyOS手表Demo——定位套件（下）-鸿蒙开发者社区首先，在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，即可完成脚本文件的同步。

【木棉花】HarmonyOS手表Demo——定位套件（下）-鸿蒙开发者社区 添加应用权限

打开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;

【木棉花】HarmonyOS手表Demo——定位套件（下）-鸿蒙开发者社区

创建完成后，在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;
    }

}

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

效果图如下：

【木棉花】HarmonyOS手表Demo——定位套件（下）-鸿蒙开发者社区