ChinaDragon10的博客

卡片提供方可以通过updateForm接口进行主动刷新。推荐与卡片生命周期回调onFormEvent、onUpdateForm、onAddForm接口搭配使用。

在EntryFormAbility.ets中，实现FormExtensionAbility生命周期接口，其中在onAddForm的入参want中可以通过FormParam取出卡片的相关信息。

ArkTS卡片中提供了postCardAction接口用于动态卡片内部和提供方应用间的交互，当前支持router、message和call三种类型的事件，仅在卡片控件的点击事件中可以调用。

由于ArkTS天然线程安全，而Native侧代码需要开发者自行保障线程安全。Native侧C++子线程不可跨线程直接访问ArkTS对象。为此，Node-API提供了可保障线程异步执行与通信安全的机制 —— 线程安全函数。

在模块的CMakeLists.txt编译脚本中通过add_library添加所需的预构建库，并声明预构建库路径等信息后，可以在target_link_libraries中声明链接该预构建库

使用命令行CMake构建NDK工程

HarmonyOS NDK默认使用CMake作为构建系统。NDK通过CMake和Ninja编译应用的C/C++代码。

在module.json5配置文件中abilities标签下的supportWindowMode属性增加“floating”字段或使用缺省值以声明应用支持悬浮窗。在module.json5配置文件中abilities标签下的supportWindowMode属性增加“split”字段或使用缺省值以声明应用支持分屏。

Video组件用于播放视频文件并控制其播放状态，常用于为短视频和应用内部视频的列表页面。当视频完整出现时会自动播放，用户点击视频区域则会暂停播放，同时显示播放进度条，通过拖动播放进度条指定视频播放到具体位置。

开发者可以NativeWindowEventFilter模块提供的能力去拦截按键事件，让按键事件不往应用内部组件分发。

当ArkTS侧在import一个so库时，只有首次调用会加载模块信息，触发模块注册。当工程被多次import时，是不会多次加载的。

Node-API支持的数据类型和接口

Progress是进度条显示组件，显示内容通常为目标操作的当前进度。

QRCode显示单个二维码的组件

Counter 计数器组件，提供相应的增加或者减少的计数操作。

通过文本显示计时信息并控制其计时器状态的组件。在组件不可见时时间变动将停止，组件的可见状态基于onVisibleAreaChange处理，可见阈值ratios大于0即视为可见状态。

相机选择器提供相机拍照与录制的能力。应用可选择媒体类型实现拍照和录制的功能。调用此类接口时，应用必须在界面UIAbility中调用，否则无法启动cameraPicker应用。

相机管理器类，使用前需要通过getCameraManager接口获取相机管理实例

调用replacePhotoPickerPreview()替换图片/视频；调用saveTrustedPhotoAssets()保存图片/视频到图库；该接口使用依赖pickerController.replacePhotoPickerPreview，需要先执行pickerController.replacePhotoPickerPreview后才能执行pickerController.saveTrustedPhotoAssets。

@ohos.file.storageStatistics getCurrentBundleStats 获取当前应用的存储空间大小（单位为Byte）。@ohos.file.storageStatistics getFreeSize 异步获取内置存储的可用空间大小（单位为Byte）。说明：从API version 15开始，支持该接口。@ohos.file.storageStatistics getFreeSizeSync 同步获取内置存储的可用空间大小（单位为Byte）。

开发者通过基础文件操作接口（ohos.file.fs）实现应用文件访问能力。应用需要对应用文件目录下的应用文件进行查看、创建、读写、删除、移动、复制、获取属性等访问操作。注意使用基础文件操作接口时，耗时较长的操作，例如：read、write等，建议使用异步接口，避免应用崩溃。

开发者可以在布局中嵌入AlbumPickerComponent组件，通过此组件，应用无需申请权限，即可访问公共目录中的相册列表。需配合PhotoPickerComponent一起使用，用户通过AlbumPickerComponent组件选择对应相册并通知PhotoPickerComponent组件刷新成对应相册的图片和视频。

当应用需要读取用户图片时，开发者可以在应用界面中嵌入PhotoPicker组件，在用户选择所需要的图片资源后，直接返回该图片资源，而不需要授予应用读取图片文件的权限，即可完成图片或视频文件的访问和读取。

指定URI读取文件数据;媒体库支持Picker选择媒体文件URI后，根据指定URI获取图片或视频资源

使用Refresh组件实现页面下拉刷新

进入到app首页或者分页列表首页时，随着页面滚动，分类tab要求固定悬浮在顶部。进入到app首页、者分页列表首页、商品详情页时，页面滚动时，顶部导航栏（菜单、标题）背景渐变。

中国大陆使用GCJ02坐标系，中国台湾和海外使用WGS84坐标系。若使用WGS84坐标系直接叠加在华为地图上，因坐标值不同，展示位置会有偏移。所以，在中国大陆如果使用WGS84坐标调用Map Kit服务，需要先将其转换为GCJ02坐标系再访问。

位置服务提供GNSS定位、网络定位（蜂窝基站、WLAN、蓝牙定位技术）、地理编码、逆地理编码、国家码和地理围栏等基本功能。

当应用申请user_grant权限时，需要完成以下步骤：在配置文件中，声明应用需要请求的权限。将应用中需要申请权限的目标对象与对应目标权限进行关联，让用户明确地知道，哪些操作需要用户向应用授予指定的权限。

获取屏幕顶部状态栏、底部导航栏和导航条的高度可以使用window的getWindowAvoidArea方法获取

vp具体计算公式为：vp= px/（DPI/160）px就是屏幕真实物理像素值，densityPixels是屏幕密度；densityDPI就是我们通常所说的系统屏幕密度，densityPixels就是屏幕密度和标准dpi(160)的比率。

实现状态栏背景颜色沉浸。为了避免状态栏颜色和背景重合，需要根据状态栏以及内容区域的颜色进行沉浸式适配

在HarmonyOS应用开发中，UIAbilityContext的terminateSelf()方法被用来结束当前的UIAbility实例。如果希望在调用terminateSelf()后，让应用在最近任务列表中不保留快照，可以通过在module.json5配置文件中配置removeMissionAfterTerminate为true来实现。

拖拽流程可以分为三部分：发起拖拽、拖拽中和释放拖拽。其中，拖出方通过 draggable() 和 onDragStart() 等接口处理拖出数据，拖入方通过allowDrop()和onDrop()等接口处理拖入数据，拖拽数据使用UDMF统一数据对象UnifiedData 进行封装。

网格对象的编辑排序是用于网格对象的编辑、拖动排序、新增和删除。

Stack：堆叠容器，子组件按照顺序依次入栈，后一个子组件覆盖前一个子组件。

Grid网格元素拖拽交换功能实现是通过Grid容器组件、组合手势、显式动画结合来实现的。Grid组件可以构建网格元素布局。组合手势可以实现元素拖拽交换的效果。显式动画可以给元素拖拽交换的过程中，添加动画效果。

约束限制设备协同数据库，针对每条记录，Key的长度≤896 Byte，Value的长度<4 MB。单版本数据库，针对每条记录，Key的长度≤1 KB，Value的长度<4 MB。每个应用程序最多支持同时打开16个键值型分布式数据库。键值型数据库事件回调方法中不允许进行阻塞操作，例如修改UI组件。

使用Node-API实现跨语言交互，首先需要按照Node-API的机制实现模块的注册和加载等相关动作。ArkTS/JS侧：实现C++方法的调用。代码比较简单，import一个对应的so库后，即可调用C++方法。Native侧：.cpp文件，实现模块的注册。需要提供注册lib库的名称，并在注册回调方法中定义接口的映射关系，即Native方法及对应的JS/ArkTS接口名称等。

Native Module：开发者使用Node-API开发的模块，用于在ArkTS侧导入使用。Node-API：实现ArkTS与C/C++交互的逻辑。ModuleManager：Native模块管理，包括加载、查找等。ScopeManager：管理napi_value的生命周期。ReferenceManager：管理napi_ref的生命周期。NativeEngine：ArkTS引擎抽象层，统一ArkTS引擎在Node-API层的接口行为。