刚出炉的鸿蒙通讯录Demo！

鸿蒙技术社区 2021-12-09

601

通讯录 demo 主要分为联系人界面、设置紧急联系人、服务卡片 3 个模块，分为 Java 和 JS 两个版本，本篇主要讲解用尽可能的用纯 JS 去实现，实在无法实现的地方采用 JS 与 Java 结合。

感兴趣的小伙伴，可以自己根据原型效果自己尝试着去实现通讯录 demo 简易原型：

https://modao.cc/app/56d61f79d8390a50dbfbd4c0f17fb8a6006692f1#screen=sku2aiuwknvl3jn

通过学习与练习本 demo，可以延伸至以下场景：

功能开发

①联系人列表

实现效果：

核心代码参考《基于 JS 扩展的类 Web 开发范式-组件-容器组件-list》：

https://developer.harmonyos.com/cn/docs/documentation/doc-references/js-components-container-list-0000000000611496

关键属性 indexer=“true”：

<!-- list -->
    <list id="address_list" class="list-wrapper" indexer="true" indexerbubble="true" shapemode="rect"
          initialindex="0">
        <block for="{{ list_data }}">
            <list-item section="{{ $item.item_section }}" class="todo-item">
                <div class="item-wrapper" @click="onItemClick($item)" @longpress="onItemLongPress($item)">
                    <image class="item-icon" src="{{ $item.item_icon }}"></image>
                    <text class="item-name">{{ $item.item_name }}</text>
                </div>
            </list-item>
        </block>
    </list>

②三方跳转

实现效果：

js 和 java 通信：js 打开三方应用目前还不知道如何操作，我们通过 js 调 java 方法来实现跳转。

JS LocalParticleAbility 机制请看官方链接：API 6 开始支持。

参考《JS LocalParticleAbility 机制-概述》：

https://developer.harmonyos.com/cn/docs/documentation/doc-references/js-apis-localparticleability-overview-0000001064156060

通过 js 获取到 java 接口：

export default {
    data: {
       javaInterface: {}
    },

    onInit() {
        console.log(TAG + " ;onInit())");
    },

    onShow() {
        console.log(TAG + " ;onShow())");
        // onInit生命周期中Java接口对象还未创建完成，请勿在onInit中调用。
        this.javaInterface = createLocalParticleAbility('com.pvj.addresslistdemo.MyLocalParticleAbility');
    }

    onClickPhone() {
    this.javaInterface.doDial(this.item_phone)
    },
    onClickMail() {
    this.javaInterface.doMessage(this.item_phone)
    }
}

java 实现：

public class MyLocalParticleAbility implements LocalParticleAbility {
    private static MyLocalParticleAbility instance;
    Context applicationContext;
    Context context;

    private MyLocalParticleAbility(Context context) {
        this.context = context;
        this.applicationContext = context.getApplicationContext();
    }

    public static MyLocalParticleAbility getInstance(Context applicationContext) {
        if (instance == null) {
            instance = new MyLocalParticleAbility(applicationContext);

        }
        return instance;
    }

    /**
     * 跳转系统拨打电话界面
     */
    public void doDial(String destinationNum) {
      ...
    }

    public void doMessage(String telephone) {
      ....
    }

}

LocalParticleAbility 需要 register 与 deregister。

public class MainAbility extends AceAbility {
    @Override
    public void onStart(Intent intent) {
        super.onStart(intent);
        ....
        MyLocalParticleAbility.getInstance(getContext()).register(this);
    }

    @Override
    public void onStop() {
        super.onStop();
        MyLocalParticleAbility.getInstance(getContext()).deregister(this);
    }
 }

拨打电话与发送短信：

/**
 * 跳转系统拨打电话界面
 */
public void doDial(String destinationNum) {
    Intent intent = new Intent();
    Operation operation = new Intent.OperationBuilder()
        .withAction(IntentConstants.ACTION_DIAL) // 系统应用拨号盘
        .withUri(Uri.parse("tel:" + destinationNum)) // 设置号码
        .withFlags(2)
        .build();
    intent.setOperation(operation);
    // 启动Ability
    context.startAbility(intent, 10);
}

//发送短信
public void doMessage(String telephone) {
    Intent intent = new Intent();
    Operation operation = new Intent.OperationBuilder()
        .withAction(IntentConstants.ACTION_SEND_SMS)
        .withUri(Uri.parse("smsto:" + telephone)) // 设置号码
        .withFlags(Intent.FLAG_NOT_OHOS_COMPONENT)
        .build();
    intent.setOperation(operation);
    context.startAbility(intent, 11);
}

③紧急联系人

实现效果：

js 数据存储：优先用关系型数据库，发现 JS 从 API Version 7 开始支持。

js 轻量级存储：它是 key-value 的存储的方法，从 API Version 6 开始支持。

参考《数据管理-轻量级存储》：

https://developer.harmonyos.com/cn/docs/documentation/doc-references/js-apis-data-storage-0000001117163542

麻烦的是：每次存数据前，需要取一次，再新增数据；在实现服务卡片更新信息时，需要动态的更新数据。

而 java 的轻量级存储与 JS 存储的不是同一目录，目录改成一致程序出错，最终只能采用 js 与 java 通信，由 java 侧统一完成数据新增与插入。

java 数据存储实现，java 代码如下：

public class MyLocalParticleAbility implements LocalParticleAbility {
    private static MyLocalParticleAbility instance;
    private static final HiLogLabel TAG = new HiLogLabel(HiLog.DEBUG, 0x0, MyLocalParticleAbility.class.getName());
    Preferences preferences;
    public static final String KEY = "key_list";
    Context applicationContext;
    Context context;

    private MyLocalParticleAbility(Context context) {
        this.context = context;
        this.applicationContext = context.getApplicationContext();

        DatabaseHelper databaseHelper = new DatabaseHelper(applicationContext);
        String fileName = "main_list.xml"; 
        // fileName表示文件名，其取值不能为空，也不能包含路径，默认存储目录可以通过context.getPreferencesDir()获取。
        preferences = databaseHelper.getPreferences(fileName);
    }


    public static MyLocalParticleAbility getInstance(Context applicationContext) {
        if (instance == null) {
            instance = new MyLocalParticleAbility(applicationContext);

        }
        return instance;
    }


    public String getContactPersonList() {
        // context入参类型为ohos.app.Context。
        String preferencesString = preferences.getString(KEY, "");
        HiLog.info(TAG, "getContactPersonList preferencesString : " + preferencesString);
        return preferencesString;
    }


    public void addContactPersonList(String content) {
        HiLog.info(TAG, "addContactPersonList content : " + content);
        preferences.putString(KEY, content);
        preferences.flushSync();
    }
}

js 代码：

import prompt from '@system.prompt';

 onItemLongPress(item) {
        console.log(TAG + " ;onItemLongPress:" + item.item_name);
        let THIS = this;
        //点击删除时弹出对话框
        prompt.showDialog({
            title: "操作提示",
            message: "添加" + item.item_name + "为紧急联系人吗?",
            buttons: [{
                          "text": "确定",
                          "color": ""
                      },
                      {
                          "text": "取消",
                          "color": ""
                      }],
            success: function (data) {
                if (data.index == 0) {
                    THIS.addContactPersonList(item);
                } 
            }
        });
    }

  async addContactPersonList(item) {
        let content =  await this.getContactPersonList();
        console.info(TAG + "addContactPersonList content: " + content);

        let list = []
        if(content != ""){
            list = JSON.parse(content);
        }
        list.push(item);
        let temp = JSON.stringify(list);
        console.info(TAG + "addContactPersonList temp: " + temp);

        this.javaInterface.addContactPersonList(temp).then();
        return true
        // store.putSync(key, temp);
    },
   async getContactPersonList() {
        let ret = await this.javaInterface.getContactPersonList()
        console.info(TAG + "getContactPersonList ret:" + ret);
        return ret
    }

④js 服务卡片

实现效果：

创建卡片模板：

卡片数据绑定：

public ProviderFormInfo bindFormData(long formId) {
    HiLog.info(TAG, "bind form data");
    ZSONObject zsonObject = new ZSONObject();
    String contactPersonList = MyLocalParticleAbility.getInstance(context.getApplicationContext()).getContactPersonList();
    JSONArray jsonArray = JSON.parseArray(contactPersonList);
    for (int i = 0; i < jsonArray.size(); i++) {
        String name = jsonArray.getJSONObject(i).getString("item_name");
        String phone = jsonArray.getJSONObject(i).getString("item_phone");
        if (i == 0) {
            zsonObject.put("titleText", name);
            zsonObject.put("contentText", phone);
        } else if (i == 1) {
            zsonObject.put("titleText1", name); 
            zsonObject.put("contentText1", phone); //传递的是string；是否支持其他类型？比如数组
        } else {
            break;
        }
        HiLog.info(TAG, "bind form data :" + jsonArray.getJSONObject(i).get("item_name"));
        HiLog.info(TAG, "bind form data :" + jsonArray.getJSONObject(i).get("item_phone"));
    }

    ProviderFormInfo providerFormInfo = new ProviderFormInfo();
    providerFormInfo.setJsBindingData(new FormBindingData(zsonObject));

    return providerFormInfo;
}

事件处理：

{
  "data": {
    "appName": "紧急联系人",
    "contactPersonList": "",
    "titleText": "Title",
    "contentText": "Introduction",
    "titleText1": "",
    "contentText1": "",
    "actionName1": "Action 1",
    "actionName2": "Action 2"
  },
  "actions": {
    "routerEvent": {
      "action": "router",
      "abilityName": "com.pvj.addresslistdemo.MainAbility",
      "params": {
        "message": "weather"
      }
    },
    "callEvent1": {
      "action": "message",
      "params": {
        "mAction": "callEvent1"
      }
    },
    "callEvent2": {
      "action": "message",
      "params": {
        "mAction": "callEvent2" // 
      }
    }
  }
}

call 就是前面的播打电话的方法：

@Override
public void onTriggerFormEvent(long formId, String message) {
    HiLog.info(TAG, "handle card click event." + message);

    ZSONObject zsonObject = ZSONObject.stringToZSON(message);

    // Do something here after receive the message from js card
    ZSONObject result = new ZSONObject();
    switch (zsonObject.getString("mAction")) {
        case "callEvent1":
            call(0);
            break;
        case "callEvent2":
            call(1);
            break;
    }
}

注意事项

Demo 还有很多需要完善的地方。

①删除时，索引不会被删除。

②索引想要自定义样式，目前实现不了。

③运行在 api 为 7 的手机的 bug，一开始莫名的#显示。

④纯 js 实现一个应用，目前还是行不通。

⑤js 官方文档上，有些不是很完善和稳定，对入门选手极其不友好。

总结

有不对或者更优的处理技术方案请多多指教，共同学习，共同进步。

代码地址：

https://gitee.com/guangdong-wangduoyu/addresslistdemo

作者：彭为杰

👇扫码报名周六的小熊派新品线上发布会，抽取 2 块新品开发板👇

👇点击关注鸿蒙技术社区👇

了解鸿蒙一手资讯

求分享

求点赞

求在看

数据库

文章转载自鸿蒙技术社区，如果涉嫌侵权，请发送邮件至：contact@modb.pro进行举报，并提供相关证据，一经查实，墨天轮将立刻删除相关内容。

刚出炉的鸿蒙通讯录Demo！

①联系人列表

实现效果：

核心代码参考《基于 JS 扩展的类 Web 开发范式-组件-容器组件-list》：

②三方跳转

实现效果：

js 和 java 通信：js 打开三方应用目前还不知道如何操作，我们通过 js 调 java 方法来实现跳转。

拨打电话与发送短信：

③紧急联系人

实现效果：

js 数据存储：优先用关系型数据库，发现 JS 从 API Version 7 开始支持。

java 数据存储实现，java 代码如下：

④js 服务卡片

实现效果：

创建卡片模板：

卡片数据绑定：

事件处理：

评论