uniappx插件nutpi-idcard 开发与使用指南（适配鸿蒙）

uniappx插件nutpi-idcard 开发与使用指南（适配鸿蒙）

前言

nutpi-idcard 是一个基于 UTS (uni-app TypeScript Syntax) 开发的 uni-app 插件适配鸿蒙，主要用于解析身份证号码，提取其中的关键信息，如地区、出生日期、性别等。本插件支持中国居民身份证、港澳台居民居住证以及外国人永久居留身份证。

本文将详细介绍 nutpi-idcard 插件的开发过程和使用方法，希望能为其他开发者提供一些参考。

插件功能

  • 身份证号码解析：能够从身份证号码中提取省市区（或国家/地区）、出生日期、性别等信息。
  • 支持多种证件类型：
    • 中国居民身份证
    • 港澳台居民居住证
    • 外国人永久居留身份证
  • 纯 UTS 实现：确保了插件在 uni-app x 及其他支持 UTS 的环境中的兼容性和性能。
  • 跨平台支持：理论上支持所有 uni-app 支持的平台，特别是针对 App (Android, iOS, HarmonyOS) 进行了适配。

开发过程

1. 项目初始化与环境搭建

插件的开发基于 HBuilderX，利用其对 uni-app 和 UTS 的良好支持。

  • 创建 uni-app 项目：首先，创建一个标准的 uni-app 项目（如果还没有的话）。
  • 创建 uni_module：在项目根目录下创建 uni_modules 文件夹（如果不存在），然后在其中创建 nutpi-idcard 文件夹作为插件的根目录。
  • 配置文件 package.json：在 nutpi-idcard 目录下创建 package.json 文件，用于定义插件的基本信息、依赖、平台支持等。关键配置项包括：
    • id: 插件的唯一标识。
    • displayName: 插件在 HBuilderX 中显示的名称。
    • version: 插件版本号。
    • description: 插件描述。
    • author: 作者信息-坚果派。
    • contact: 联系方式。
    • repository: 代码仓库地址。
    • engines: HBuilderX 版本要求。
    • dcloudext: DCloud 扩展配置，如插件类型 (uts)、销售信息等。
    • uni_modules: uni-app 模块配置，如依赖、加密、平台支持等。

2. 核心逻辑实现 (utssdk)

插件的核心代码位于 utssdk 目录下，针对不同平台可以有不同的实现，但本项目中主要关注通用的 UTS 实现，特别是针对 HarmonyOS 的适配。

  • 目录结构：

    nutpi-idcard/
├── utssdk/
│   ├── app-harmony/         # HarmonyOS 平台特定代码
│   │   ├── index.uts        # HarmonyOS 入口及核心逻辑
│   │   ├── interfaces.uts   # TypeScript 接口定义
│   │   └── module/
│   │       └── data/        # 数据文件 (行政区划、国家代码)
│   │           ├── china.uts
│   │           └── international.uts
│   ├── app-android/       # Android 平台 (如果需要特定实现)
│   ├── app-ios/           # iOS 平台 (如果需要特定实现)
│   ├── index.uts          # 插件主入口 (通常导出各平台实现)
│   └── interfaces.uts     # 通用接口定义
├── package.json
├── readme.md
└── changelog.md

  • 数据准备 (module/data/)：

    • china.uts: 存储中国行政区划代码与名称的映射。
    • international.uts: 存储 ISO 3166-1 国家代码与名称的映射。

  • 接口定义 (interfaces.uts)：
    定义了身份证解析结果的数据结构 IDResult。

    export interface IDResult {type?: string;       // 证件类型sign?: string;       // 签发机关或地区country?: string;    // 国家或地区birthday?: string;   // 出生日期 (YYYY-MM-DD)sex?: string;        // 性别 ('男' 或 '女')isValid?: boolean;   // 校验结果 (当前版本简单返回 true)
}

  • 核心解析逻辑 (app-harmony/index.uts)：
    这是插件的核心，包含了主要的解析函数。

    • parseID(id: string): IDResult: 公开的 API 函数，根据身份证号码的格式（通过正则表达式判断）调用相应的内部解析函数。
    • parserChina(id: string): IDResult: 解析中国居民身份证和港澳台居民居住证。
      • 通过身份证号码的前6位确定省市区。
      • 通过第7到14位确定出生日期。
      • 通过第17位（顺序码的最后一位）确定性别。
    • parserInternational(id: string): IDResult: 解析外国人永久居留身份证。
      • 通过第1到3位（国家或地区代码）和 international.uts 数据确定国家。
      • 通过第7到14位确定出生日期。
      • 通过第17位确定性别。
    • isIdCardValidInternal(id: string): boolean: 身份证号码有效性校验函数。目前简单返回 true，未来可以根据国家标准实现更复杂的校验逻辑（如校验码计算）。
    // idcard/uni_modules/nutpi-idcard/utssdk/app-harmony/index.uts
import { chinaData as _china } from './module/data/china.uts';
import { internationalData as _international } from './module/data/international.uts';
import type { IDResult } from './interfaces.uts';function parserInternational(id: string): IDResult { /* ... */ }
function parserChina(id: string): IDResult { /* ... */ }
function isIdCardValidInternal(id: string): boolean { /* ... */ }export function parseID(id: string): IDResult {if(id.match(/^9\d{16}[0-9xX]$/)){ // 外国人永久居留身份证特征 (假设以9开头)return parserInternational(id);}else if(id.match(/^\d{17}[0-9xX]$/)){ // 中国居民身份证特征return parserChina(id);}else{return { type: '未知类型' };}
}

3. 插件入口 (index.uts)

在 nutpi-idcard 根目录下的 index.uts 文件通常作为插件的统一入口，它会根据当前运行平台导出相应平台的 parseID 函数。

// idcard/uni_modules/nutpi-idcard/index.uts
// #ifdef APP-HARMONY
export * from './utssdk/app-harmony/index.uts';
// #endif// #ifdef APP-PLUS || APP-VUE
// 假设 Android 和 iOS 使用相同的 UTS 逻辑，或者有单独的 app-android/index.uts 和 app-ios/index.uts
// 如果 utssdk/index.uts 包含了 Android 和 iOS 的通用逻辑，可以这样导出：
// export * from './utssdk/index.uts'; 
// 或者分别导出
// #ifdef APP-ANDROID
// export * from './utssdk/app-android/index.uts';
// #endif
// #ifdef APP-IOS
// export * from './utssdk/app-ios/index.uts';
// #endif
// #endif// 默认导出 (如果需要在非特定App平台使用，或者作为H5等平台的兜底)
// export * from './utssdk/index.uts'; // 假设 utssdk/index.uts 包含通用或web实现

注意：上述 index.uts 的条件编译部分需要根据实际支持的平台和代码组织来编写。如果主要目标是 HarmonyOS，则 APP-HARMONY 部分是关键。

4. 文档编写

  • readme.md: 提供插件的详细说明，包括功能特性、安装方法、API 文档、使用示例、作者信息等。
  • changelog.md: 记录插件的版本更新历史和主要变更。

5. 测试与调试

  • 在 HBuilderX 中创建测试页面，引入插件并调用 parseID 函数，传入不同的身份证号码进行测试。
  • 关注控制台输出，确保解析结果的准确性。
  • 针对不同平台（特别是 HarmonyOS）进行真机或模拟器测试。

遇到的问题与解决

  • UTS 模块导入路径：UTS 中模块导入路径需要精确。最初可能因为 method.uts 和 index.uts 的拆分导致函数重复声明或找不到定义的问题。通过将 method.uts 的内容合并到 index.uts 中解决了此问题。
  • Git 推送标签失败：在版本发布时，如果本地没有对应的 Git 标签，git push origin <tagname> 会失败。通过先执行 git tag <tagname> 创建本地标签，然后再推送解决。
  • 函数未定义错误：在页面中调用插件函数时，如果导入路径不正确或插件未正确导出函数，会导致 xxx is not defined 错误。仔细检查插件的 index.uts 导出逻辑和页面中的导入路径，确保一致。

如何使用 nutpi-idcard 插件

  1. 安装插件：

    • 从 DCloud 插件市场安装。插件地址：https://ext.dcloud.net.cn/plugin?id=23728
    • 或者，如果手动引入，将 nutpi-idcard 整个文件夹复制到你的 uni-app 项目的 uni_modules 目录下。

  2. 引入插件：在需要使用的页面或组件的 <script setup lang="uts"> 或 <script lang="uts"> 中引入插件。

    // 示例：在页面的 <script setup lang="uts"> 中
import { parseID } from '@/uni_modules/nutpi-idcard'; // HBuilderX 会自动处理路径映射
// 如果在 uni-app x 项目的 .uvue 文件中，路径可能需要更明确，或者依赖 HBuilderX 的智能提示

  3. 调用解析函数：使用 parseID 函数解析身份证号码。

    const idNumber = '110101199003070978'; // 替换为实际的身份证号码
const idInfo = parseID(idNumber);if (idInfo) {console.log('证件类型:', idInfo.type);console.log('签发地/国家:', idInfo.sign ?? idInfo.country);console.log('出生日期:', idInfo.birthday);console.log('性别:', idInfo.sex);console.log('是否有效:', idInfo.isValid);
}

API 参考

parseID(id: string): IDResult

解析身份证号码并返回包含详细信息的对象。

  • 参数：

    • id: string - 需要解析的身份证号码（18位中国居民身份证，或外国人永久居留身份证等）。

  • 返回值：IDResult 对象，其结构如下：

    interface IDResult {type?: string;       // 证件类型 (例如：'居民身份证', '外国人永久居留身份证', '港澳台居民居住证', '未知类型')sign?: string;       // 签发机关或地区信息 (例如：'北京市市辖区', '北京市朝阳区')country?: string;    // 国家或地区 (例如：'中国', '无国籍' 或其他国家名称，主要用于外国人身份证)birthday?: string;   // 出生日期，格式为 'YYYY-MM-DD'sex?: string;        // 性别 ('男' 或 '女')isValid?: boolean;   // 身份证号码是否有效 (当前版本简单返回true，待实现详细校验逻辑)
}

未来展望

  • 完善校验逻辑：实现更严格的身份证号码校验，包括校验码的计算与验证。
  • 更广泛的证件类型支持：考虑支持更多国家或地区的身份证件类型。
  • 性能优化：对数据查找和字符串处理进行优化，提高解析效率。
  • 更详细的错误提示：当输入格式错误或无法解析时，提供更具体的错误信息。
  • 单元测试：为插件编写完善的单元测试，确保代码质量和稳定性。

作者与联系方式

  • 作者：坚果派
  • 公众号：nutpi
  • 电话：17752170152
  • 官网：https://www.nutpi.net/
  • 代码仓库：https://gitcode.com/nutpi/uni-idcard

希望这个插件能对您有所帮助！如果您有任何问题或建议，欢迎联系。

坚果派

坚果派社区由小波、狼哥等人创建，团队拥有数位华为HDE及1000+HarmonyOS开发者，以及若干其他领域的三十余位万粉博主/UP主运营。

专注于分享的技术包括HarmonyOS/OpenHarmony、仓颉、ArkUI-X、元服务、AI、BlueOS操作系统等。团队成员主要聚集在北京，上海，南京，深圳，广州，苏州、长沙、宁夏等地，目前已为华为、vivo、腾讯、亚马逊以及三方技术社区提供各类开发咨询服务100+。累计粉丝100+w，孵化开发者10w+，高校20+、企业10+。自研应用40款，三方库80个，鸿蒙原生应用课程500+。持续助力鸿蒙仓颉等生态繁荣发展。

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.pswp.cn/pingmian/83798.shtml

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈email:809451989@qq.com，一经查实，立即删除！

相关文章

Grafana-ECharts应用讲解（玫瑰图示例）

Grafana-ECharts应用讲解（玫瑰图示例）

工具： MySQL 数据库 MySQL Workbench 数据库管理工具（方便编辑数据） Grafana v11.5.2 Business Charts 6.6（原 Echarts插件） 安装 安装 MySQL社区版安装 MySQL Workbench安装 Grafana在 Grafana 插件中搜索 Business Charts 进行安装以上安装步骤网上教程很多，自行搜…
阅读更多...
React状态管理Context API + useReducer

React状态管理Context API + useReducer

在 React 中&#xff0c;Context API useReducer 是一种轻量级的状态管理方案&#xff0c;适合中小型应用或需要跨组件共享复杂状态的场景。它避免了 Redux 的繁琐配置&#xff0c;同时提供了清晰的状态更新逻辑。 1. 基本使用步骤 (1) 定义 Reducer 类似于 Redux 的 reduce…
阅读更多...
3 个优质的终端 GitHub 开源工具

3 个优质的终端 GitHub 开源工具

1、Oh My Zsh Oh My Zsh 是一个帮助你管理和美化 zsh 终端的开源工具。它让你的终端更炫酷、更高效。安装后&#xff0c;你可以快速使用各种插件和主题&#xff0c;比如常见的 git 命令简化、支持多种编程语言工具等&#xff0c;每次打开终端都会有惊喜。无论你是开发者还是普…
阅读更多...
无人机巡检智能边缘计算终端技术方案‌‌——基于EFISH-SCB-RK3588工控机/SAIL-RK3588核心板的国产化替代方案‌

无人机巡检智能边缘计算终端技术方案‌‌——基于EFISH-SCB-RK3588工控机/SAIL-RK3588核心板的国产化替代方案‌

一、方案核心价值‌ ‌实时AI处理‌&#xff1a;6TOPS NPU实现无人机影像的实时缺陷检测&#xff08;延迟&#xff1c;50ms&#xff09;‌全国产化‌&#xff1a;芯片、操作系统、算法工具链100%自主可控‌极端环境适配‌&#xff1a;-40℃~85℃稳定运行&#xff0c;IP65防护等…
阅读更多...
SpringAI 1.0.0 正式版——利用Redis存储会话（ChatMemory）

SpringAI 1.0.0 正式版——利用Redis存储会话（ChatMemory）

官方文档&#xff1a;Chat Memory :: Spring AI Reference 1. 引言 SpringAI 1.0.0 改动了很多地方&#xff0c;本文根据官方的InMemoryChatMemoryRepository实现了自定义的RedisChatMemoryRepository&#xff0c;并使用MessageWindowChatMemory创建ChatMemory 2. 实现 2.1.…
阅读更多...
RFC8489-STUN

RFC8489-STUN

0. 学习参考 RFC5389 中文翻译 中文RFC RFC文档 RFC翻译 RFC中文版 RFC 5389&#xff1a;NAT 的会话遍历实用程序 &#xff08;STUN&#xff09; --- RFC 5389: Session Traversal Utilities for NAT (STUN) 1. RFC 3489的演变 自 RFC 3489 发布以来的经验发现&#xff0c;…
阅读更多...
开始在本地部署自己的 Gitea 服务器

开始在本地部署自己的 Gitea 服务器

0.简介 在软件开发和团队协作中&#xff0c;代码管理是至关重要的环节。笔者一直使用gitblit管理自己的仓库。然鹅&#xff0c;这个软件已经很久没有更新了。经过多方考察&#xff0c;发现Gitea 是一款轻量级的开源代码托管平台&#xff0c;具有易于部署、资源占用少、功能丰富…
阅读更多...
Xsens-AAA工作室品质，为动画师准备

Xsens-AAA工作室品质，为动画师准备

每一帧都讲述着一个故事&#xff0c;当动作真实呈现时&#xff0c;故事便鲜活起来。我们打造并改进了 Xsens Animate&#xff0c;助力专业人士突破数字动画的界限。 通过升级后的 Xsens Animate&#xff0c;您可以获得女性和男性解剖模型以及更精确的运动引擎&#xff0c;从一…
阅读更多...
嵌入（Embedding）技术的实现原理与应用场景解析

嵌入（Embedding）技术的实现原理与应用场景解析

嵌入&#xff08;Embedding&#xff09;技术的实现原理与应用场景解析 引言&#xff1a;从One-Hot到语义空间 在自然语言处理的演进历程中&#xff0c;嵌入技术&#xff08;Embedding&#xff09;的诞生标志着一个重要转折点——它让离散的符号表示突破了维度诅咒&#xff0c…
阅读更多...
金仓数据库征文-金仓KES数据同步优化实践：逻辑解码与增量同步

金仓数据库征文-金仓KES数据同步优化实践：逻辑解码与增量同步

目录 一.同步场景与方案选型 二.什么是KES 三.同步环境配置 1.前置条件验证 2.逻辑解码配置 四.同步实施与问题排查 1.结构映射规则 2.增量数据捕获 3.数据一致性校验 五.性能调优实践 1.同步线程优化 2.批量提交优化 3.资源监控指标 六.典型场景解决方案 1.双向…
阅读更多...
开源语义分割工具箱mmsegmentation基于Lovedata数据集训练模型

开源语义分割工具箱mmsegmentation基于Lovedata数据集训练模型

开源语义分割工具箱mmsegmentation安装环境 文章目录 1、下载数据集2、整理数据集3、下载预训练模型4、测试5、训练模型参考官方数据处理步骤 https://github.com/open-mmlab/mmsegmentation/blob/main/docs/zh_cn/user_guides/2_dataset_prepare.md#loveda 数据集类别标签：…
阅读更多...
Python概率统计可视化——概率分布、假设检验与分子运动模型

Python概率统计可视化——概率分布、假设检验与分子运动模型

Python概率统计可视化——概率分布、假设检验与分子运动模型 前言 概率统计作为描述不确定性和随机现象的数学工具&#xff0c;广泛应用于物理学、生物学、经济学等领域。然而&#xff0c;抽象的概率分布和统计推断过程往往难以直观理解。可视化技术通过将概率密度、假设检验逻…
阅读更多...
NLP学习路线图（二十二）： 循环神经网络（RNN）

NLP学习路线图（二十二）： 循环神经网络（RNN）

在自然语言处理&#xff08;NLP&#xff09;的广阔天地中&#xff0c;序列数据是绝对的核心——无论是流淌的文本、连续的语音还是跳跃的时间序列&#xff0c;都蕴含着前后紧密关联的信息。传统神经网络如同面对一幅打散的拼图&#xff0c;无法理解词语间的顺序关系&#xff0c…
阅读更多...
禅道5月更新速览 | 新增交付物配置功能，支持建立跨执行任务依赖关系，研发效能平台上线

禅道5月更新速览 | 新增交付物配置功能，支持建立跨执行任务依赖关系，研发效能平台上线

禅道体验又升级啦&#xff01;禅道5月新功能合集来啦&#xff0c;研发效能平台与大家见面啦&#xff01; 我们将继续坚持&#xff0c;月月有大招&#xff0c;迭代不停歇&#xff0c;快来更新禅道&#xff0c;体验全新的项目管理工具吧~ ​
阅读更多...
【PDF PicKiller】PDF批量删除固定位置图片工具，默认解密，可去一般图、背景图、水印图！

【PDF PicKiller】PDF批量删除固定位置图片工具，默认解密，可去一般图、背景图、水印图！

PDF批量删除固定位置图片工具 PDF PicKiller <center>PDF PicKiller [Download](https://github.com/Peaceful-World-X/PDF-PicKiller)&#x1f929; 工具介绍&#x1f973; 主要功能&#x1f92a; 软件使用&#x1f92a; 参数解释&#x1f92a; 关键代码&#x1f929; 项…
阅读更多...
kubeadm安装k8s

kubeadm安装k8s

1、环境准备 1.1、升级系统内核 参考另一篇文章&#xff1a;https://blog.csdn.net/u012533920/article/details/148457715?spm1011.2415.3001.5331 1.2、设置Hostname cat <<EOF > /etc/hosts 127.0.0.1 localhost localhost.localdomain localhost4 localhos…
阅读更多...
Vue基础(14)_列表过滤、列表排序

Vue基础(14)_列表过滤、列表排序

Array.prototype.filter()【ES5】 filter() 方法创建给定数组一部分的浅拷贝&#xff0c;其包含通过所提供函数实现的测试的所有元素。 语法&#xff1a; filter(callbackFn) filter(callbackFn, thisArg) 参数&#xff1a; callbackFn(回调函数)&#xff1a;为数组中的每个元…
阅读更多...
ComfyUI 中如何使用 Depth ControlNet SD1.5

ComfyUI 中如何使用 Depth ControlNet SD1.5

目录 SD1.5 Depth ControlNet 简介 Depth ControlNet 主要特点 SD1.5 Depth ControlNet工作流准备工作 1. 安装必要插件 方式一：使用 ComfyUI Manager（推荐） 方式二：通过 git 安装必要插件 方式三：手动安装（不推荐） 2.1 下载工作流所需模型 2.2 模型存放位置 SD…
阅读更多...
IoT/HCIP实验-3/LiteOS操作系统内核实验(任务、内存、信号量、CMSIS..)

IoT/HCIP实验-3/LiteOS操作系统内核实验(任务、内存、信号量、CMSIS..)

文章目录 概述HelloWorld 工程C/C配置编译器主配置Makefile脚本烧录器主配置运行结果程序调用栈 任务管理实验实验结果osal 系统适配层osal_task_create 其他实验实验源码内存管理实验互斥锁实验信号量实验 CMISIS接口实验还是得JlINKCMSIS 简介LiteOS->CMSIS任务间消息交互…
阅读更多...
mysql的分页场景下，页数越大查询速度越慢的解决方法

mysql的分页场景下，页数越大查询速度越慢的解决方法

一 问题描述 select * from table limit 0,10扫描满足条件的10行&#xff0c;返回10行&#xff0c; 但当limit 99989,10的时候数据读取就很慢,limit 99989,10的意思扫描满足条件的99999行&#xff0c;扔掉前面的99989行&#xff0c;返回最后的10行&#xff0c;这样速度就会很慢…
阅读更多...
最新文章

Copyright @ 2022~2023