鸿蒙@kit包
HarmonyOS NEXT API 15 官方开发套件提供了10大核心功能模块,涵盖应用开发全场景需求。主要包括:应用核心框架(AbilityKit、ArkUI等)、系统基础服务(弹窗、安全等)、网络连接、文件管理、安全加密、媒体图形、AI能力、硬件感知、应用生态和行业扩展。每个模块提供清晰的API调用示例,如AbilityKit实现页面跳转、BasicServicesKit展示Toast提示、
·
HarmonyOS NEXT API 15 官方 @kit.包名 API
分类目录:
1. 应用核心框架
2. 系统基础服务
3. 网络与连接
4. 文件与资源管理
5. 安全与加密
6. 媒体与图形绘制
7. AI智能能力
8. 设备与硬件感知
9. 应用生态服务
10. 行业专属扩展
1. 应用核心框架
@kit.AbilityKit // 应用上下文、页面路由、窗口、生命周期、服务管理 使用方式:页面跳转、获取上下文、窗口操作、应用退出、权限请求 示例: import { UIAbilityContext, window } from '@kit.AbilityKit'; const context = this.uiContext.getHostContext() as UIAbilityContext; context.startAbility({ uri: 'pages/Index' }); context.terminateSelf(); window.getLastWindow(context);@kit.AccessibilityKit // 无障碍服务、读屏、辅助操作
使用方式:检测无障碍状态、监听状态变化
示例:
import { accessibility } from '@kit.AccessibilityKit';
accessibility.isOpenAccessibilitySync();
accessibility.on('accessibilityStateChange', (state) => {});
@kit.ArkData // 响应式状态、跨组件数据共享
使用方式:创建可观察对象、监听数据变更
示例:
import { Observable, observe } from '@kit.ArkData';
const store = Observable({ count: 0 });
observe(store, 'count', (val) => {});
@kit.ArkTS // 并发任务、异步调度、基础类型
使用方式:多线程任务、异步逻辑处理
示例:
import { taskpool } from '@kit.ArkTS';
taskpool.execute(() => { console.log('并发任务执行'); });
@kit.ArkUI // 声明式UI、组件、布局、手势、动画
使用方式:页面搭建、组件开发、事件绑定
示例:
@Entry
@Component
struct IndexPage {
build() {
Column(){ Text('鸿蒙开发').fontSize(30) }
}
}
@kit.ArkWeb // Web容器、H5混合开发、JS通信
使用方式:加载网页、原生与H5互调
示例:
import { webview, WebController } from '@kit.ArkWeb';
const ctrl = new WebController();
webview({ src: 'https://www.baidu.com', controller: ctrl });
@kit.BackgroundTasksKit // 后台任务、延时保活、进程驻留
使用方式:申请后台延迟、执行后台任务
示例:
import { backgroundTask } from '@kit.BackgroundTasksKit';
backgroundTask.requestSuspendDelay({ name: 'background_task' });
@kit.DataAugmentationKit // 数据预加载、页面数据优化
使用方式:提前加载业务数据、提升页面速度
示例:
import { dataAugmentation } from '@kit.DataAugmentationKit';
dataAugmentation.preload({ key: 'home_page_data' });
@kit.FormKit // 桌面服务卡片、小组件管理
使用方式:更新卡片、获取卡片信息
示例:
import { formProvider } from '@kit.FormKit';
formProvider.updateForm(formId, { data: { title: '更新' } });
@kit.IMEKit // 输入法、软键盘控制
使用方式:显示/隐藏键盘、输入法管理
示例:
import { inputMethod } from '@kit.IMEKit';
inputMethod.showSoftKeyboard();
inputMethod.hideSoftKeyboard();
@kit.IPCKit // 跨进程通信、消息传递
使用方式:应用内/跨应用进程通信
示例:
import { ipc } from '@kit.IPCKit';
const port = ipc.createMessagePort();
port.postMessage('IPC数据');
@kit.LocalizationKit // 国际化、多语言、时区适配
使用方式:获取/切换语言、地区适配
示例:
import { Localization } from '@kit.LocalizationKit';
Localization.getLanguage();
Localization.setLanguage('zh-CN');
@kit.UIDesignKit // 全局主题、深色模式、设计规范
使用方式:切换主题、获取系统配色
示例:
import { theme } from '@kit.UIDesignKit';
theme.setDarkMode(true);
2. 系统基础服务
@kit.BasicServicesKit // 弹窗、Toast、剪贴板、公共事件 使用方式:轻提示、复制文本、全局事件通信 示例: import { prompt, clipboard } from '@kit.BasicServicesKit'; prompt.showToast({ message: '操作成功' }); clipboard.setData({ text: '复制内容' });@kit.DataLossPreventionKit // 数据防泄露、文件加密
使用方式:数据脱敏、文件保护
示例:
import { dlp } from '@kit.DataLossPreventionKit';
dlp.protectFile('test.txt');
@kit.DesktopExtensionKit // 桌面多窗口、悬浮窗管理
使用方式:创建窗口、调整窗口大小
示例:
import { desktop } from '@kit.DesktopExtensionKit';
desktop.createWindow({ title: '悬浮窗' });
@kit.DeviceSecurityKit // 设备安全、权限管理、安全等级
使用方式:权限检测、设备安全校验
示例:
import { deviceSecurity } from '@kit.DeviceSecurityKit';
deviceSecurity.checkPermission('ohos.permission.CAMERA');
@kit.DistributedServiceKit // 分布式设备、跨设备流转、协同
使用方式:发现设备、跨设备数据同步
示例:
import { distributedDevice } from '@kit.DistributedServiceKit';
distributedDevice.getDeviceList();
@kit.FASTKit // 应用启动加速、冷启动优化
使用方式:预加载应用、提升启动速度
示例:
import { fast } from '@kit.FASTKit';
fast.preloadApp('com.demo.app');
@kit.FunctionFlowRuntimeKit // 业务流程编排、自动化任务
使用方式:流程调度、自动化业务
示例:
import { flow } from '@kit.FunctionFlowRuntimeKit';
flow.startFlow('order_process');
@kit.InputKit // 按键、触摸、外设输入监听
使用方式:监听物理按键、鼠标事件
示例:
import { input, KeyCode } from '@kit.InputKit';
input.on('keyDown', (key) => {});
@kit.MDMKit // 企业设备管控、策略配置
使用方式:设备策略、远程管理
示例:
import { mdm } from '@kit.MDMKit';
mdm.setPasswordPolicy({ minLength: 6 });
@kit.MultimodalAwarenessKit // 多模态感知、场景识别
使用方式:手势、环境、场景智能识别
示例:
import { multimodal } from '@kit.MultimodalAwarenessKit';
multimodal.on('sceneChange', (res) => {});
@kit.PerformanceAnalysisKit // 性能打点、耗时统计、监控
使用方式:统计加载耗时、性能优化
示例:
import { performance } from '@kit.PerformanceAnalysisKit';
performance.mark('start');
performance.measure('load_time', 'start');
@kit.RemoteCommunicationKit // 远程通信、跨设备组网
使用方式:远程设备连接、数据传输
示例:
import { remoteComm } from '@kit.RemoteCommunicationKit';
remoteComm.connect('192.168.1.100');
@kit.ServiceCollaborationKit // 跨应用服务协作、调用第三方服务
使用方式:应用间服务联动
示例:
import { serviceCollab } from '@kit.ServiceCollaborationKit';
serviceCollab.callService('service', {});
@kit.TestKit // 单元测试、自动化测试
使用方式:编写测试用例、功能校验
示例:
import { test } from '@kit.TestKit';
test.describe('unit_test', () => {});
@kit.UniversalKeystoreKit // 密钥存储、安全凭证管理
使用方式:存储密钥、加密敏感数据
示例:
import { keystore } from '@kit.UniversalKeystoreKit';
keystore.insertKey('key', 'value');
@kit.UserAuthenticationKit // 生物认证、指纹、人脸、PIN码
使用方式:身份核验、解锁验证
示例:
import { userAuth } from '@kit.UserAuthenticationKit';
userAuth.authenticate({ type: 'fingerprint' });
3. 网络与连接
@kit.ConnectivityKit // 网络状态、Wi-Fi、蓝牙、连接检测 使用方式:判断网络连通、获取网络类型 示例: import { connectivity } from '@kit.ConnectivityKit'; connectivity.getDefaultNet().isConnected();@kit.NearLinkKit // 星闪、近场通信、一碰连
使用方式:短距高速设备互联
示例:
import { nearLink } from '@kit.NearLinkKit';
nearLink.startScan();
@kit.NetworkKit // HTTP请求、GET/POST、上传下载
使用方式:接口请求、文件传输
示例:
import { http, RequestMethod } from '@kit.NetworkKit';
http.createHttp().request({ url: 'https://api.com', method: RequestMethod.GET });
@kit.NetworkBoostKit // 弱网优化、网络加速
使用方式:弱网补偿、流量压缩
示例:
import { networkBoost } from '@kit.NetworkBoostKit';
networkBoost.enableBoost(true);
@kit.TelephonyKit // 蜂窝网络、SIM卡、通话、短信
使用方式:获取运营商信息、拨号
示例:
import { telephony } from '@kit.TelephonyKit';
telephony.getDefaultSimCardInfo();
4. 文件与资源管理
@kit.AssetStoreKit // 应用静态资源、图片/文本读取 使用方式:读取rawfile、资源文件 示例: import { assetStore } from '@kit.AssetStoreKit'; assetStore.getAssetContent('rawfile/data.json');@kit.CoreFileKit // 沙箱文件读写、目录、流操作
使用方式:文件增删改查、本地存储
示例:
import { fs, FileMode } from '@kit.CoreFileKit';
const fd = fs.openSync('test.txt', FileMode.ReadWrite);
fs.writeSync(fd, '内容');
fs.closeSync(fd);
5. 安全与加密
@kit.CryptoArchitectureKit // 加解密、MD5、AES、RSA、哈希算法 使用方式:数据加密、摘要生成、签名验签 示例: import { cryptoFramework } from '@kit.CryptoArchitectureKit'; const md5 = cryptoFramework.createMd5(); md5.update('加密数据');@kit.DeviceCertificateKit // 设备证书、安全认证、验签
使用方式:获取设备证书、合法性校验
示例:
import { deviceCert } from '@kit.DeviceCertificateKit';
deviceCert.getDeviceCert();
@kit.OnlineAuthenticationKit // 在线身份认证、免密登录
使用方式:云端身份核验、账号安全
示例:
import { onlineAuth } from '@kit.OnlineAuthenticationKit';
onlineAuth.verifyToken('token');
@kit.EnterpriseDataGuardKit // 企业数据防护、隔离加密
使用方式:工作空间数据加密、隔离
示例:
import { edg } from '@kit.EnterpriseDataGuardKit';
edg.encryptData('企业数据');
6. 媒体与图形绘制
@kit.AREngine // AR增强现实、空间识别 使用方式:AR实景、空间交互 示例: import { arEngine } from '@kit.AREngine'; arEngine.startARSession();@kit.AudioKit // 音频播放、录音、音量控制
使用方式:音乐播放、语音录制
示例:
import { audio } from '@kit.AudioKit';
const player = audio.createAudioPlayer({ src: 'music.mp3' });
player.play();
@kit.AVCodecKit // 音视频编解码、压缩转码
使用方式:视频硬解、音频编码
示例:
import { avCodec } from '@kit.AVCodecKit';
avCodec.createVideoDecoder();
@kit.AVSessionKit // 音视频投屏、多设备同步
使用方式:投屏、音频共享
示例:
import { avSession } from '@kit.AVSessionKit';
avSession.createShareSession();
@kit.CameraKit // 相机预览、拍照、录像
使用方式:调用相机、拍摄媒体
示例:
import { camera, CameraPosition } from '@kit.CameraKit';
camera.createCameraInput(CameraPosition.BACK);
@kit.DRMKit // 视频版权保护、加密视频播放
使用方式:DRM解密、版权视频
示例:
import { drm } from '@kit.DRMKit';
drm.createMediaDRMInstance();
@kit.GraphicsAccelerateKit // GPU加速、图形渲染优化
使用方式:提升动画/游戏性能
示例:
import { gpu } from '@kit.GraphicsAccelerateKit';
gpu.setRenderAccelerate(true);
@kit.ImageKit // 图片压缩、裁剪、像素处理
使用方式:图片编辑、位图生成
示例:
import { image } from '@kit.ImageKit';
image.createPixelMap({ scale: 0.5 });
@kit.MediaKit // 多媒体通用播放能力
使用方式:音视频播放、基础媒体能力
示例:
import { media } from '@kit.MediaKit';
media.createAVPlayer();
@kit.MediaLibraryKit // 相册、图片、视频、媒体库
使用方式:读取本地照片、视频列表
示例:
import { mediaLibrary } from '@kit.MediaLibraryKit';
mediaLibrary.getImageAssets();
@kit.ArkGraphics2D // 2D画布、自定义绘制
使用方式:画图形、自定义控件
示例:
import { Canvas } from '@kit.ArkGraphics2D';
Canvas().onDraw((ctx) => { ctx.fillRect(0,0,100,100); });
@kit.ArkGraphics3D // 3D渲染、模型、场景加载
使用方式:3D应用、游戏渲染
示例:
import { graphics3d } from '@kit.ArkGraphics3D';
graphics3d.createScene();
@kit.SpatialReconKit // 空间感知、3D环境重建
使用方式:空间定位、建模
示例:
import { spatial } from '@kit.SpatialReconKit';
spatial.startRecon();
@kit.XEngineKit // 高性能图形引擎、游戏渲染
使用方式:游戏开发、3D渲染
示例:
import { xEngine } from '@kit.XEngineKit';
xEngine.initEngine();
7. AI智能能力
@kit.AgentFrameworkKit // AI智能代理、自动化助手 使用方式:智能任务、自动化流程 示例: import { agent } from '@kit.AgentFrameworkKit'; agent.createAgent('assistant');@kit.CANNKit // 昇腾AI算力、模型加速
使用方式:AI推理、算力调度
示例:
import { cann } from '@kit.CANNKit';
cann.init();
@kit.CoreSpeechKit // 离线语音识别、本地语音
使用方式:本地语音转文字
示例:
import { coreSpeech } from '@kit.CoreSpeechKit';
coreSpeech.startListening();
@kit.CoreVisionKit // 轻量化视觉、本地图像识别
使用方式:图像检测、本地识别
示例:
import { coreVision } from '@kit.CoreVisionKit';
coreVision.detectImage(img);
@kit.IntentsKit // 意图识别、场景唤醒
使用方式:指令解析、智能场景
示例:
import { intents } from '@kit.IntentsKit';
intents.parseIntent('打开微信');
@kit.MindSporeLiteKit // 本地AI模型、离线推理
使用方式:运行AI模型、本地计算
示例:
import { mindSpore } from '@kit.MindSporeLiteKit';
mindSpore.loadModel('model.ms');
@kit.NaturalLanguageKit // NLP自然语言处理、文本分词
使用方式:语义理解、文本处理
示例:
import { nlp } from '@kit.NaturalLanguageKit';
nlp.segment('鸿蒙开发');
@kit.NeuralNetworkRuntimeKit // 神经网络运行、AI部署
使用方式:模型加载、推理计算
示例:
import { nnrt } from '@kit.NeuralNetworkRuntimeKit';
nnrt.createModel();
@kit.SpeechKit // 在线语音识别、合成
使用方式:语音转文字、TTS播报
示例:
import { speech } from '@kit.SpeechKit';
speech.startRecognize();
@kit.VisionKit // OCR、图像检测、视觉AI
使用方式:文字识别、图片分析
示例:
import { vision } from '@kit.VisionKit';
vision.ocrImage(buffer);
8. 设备与硬件感知
@kit.DriverDevelopmentKit // 硬件驱动、外设、HDF对接 使用方式:读写硬件、外设连接 示例: import { driver } from '@kit.DriverDevelopmentKit'; driver.openDevice('/dev/hdf_xxx');@kit.SensorServiceKit // 传感器、加速度、陀螺仪、光线
使用方式:订阅传感器数据、实时监听
示例:
import { sensor, SensorType } from '@kit.SensorServiceKit';
sensor.subscribeSensorData(SensorType.ACCELEROMETER, (data) => {});
@kit.WearEngineKit // 穿戴设备、手表、手环适配
使用方式:手表数据、表盘控制
示例:
import { wearEngine } from '@kit.WearEngineKit';
wearEngine.getWatchInfo();
@kit.PenKit // 手写笔、压感、笔触绘制
使用方式:手写笔事件、压感检测
示例:
import { pen } from '@kit.PenKit';
pen.registerPenEvent((event) => {});
9. 应用生态服务
@kit.AccountKit // 鸿蒙账号、登录、授权 使用方式:账号登录、获取用户信息 示例: import { account } from '@kit.AccountKit'; account.authorize();@kit.AdsKit // 广告服务、应用变现
使用方式:加载广告、展示广告
示例:
import { ads } from '@kit.AdsKit';
ads.loadAd('ad_unit_id');
@kit.AppGalleryKit // 应用市场、版本升级
使用方式:检查更新、跳转应用市场
示例:
import { appGallery } from '@kit.AppGalleryKit';
appGallery.checkUpdate();
@kit.AppLinkingKit // 应用跳转、URL拉起、DeepLink
使用方式:跨App跳转、链接唤醒
示例:
import { appLinking } from '@kit.AppLinkingKit';
appLinking.openUrl('hap://app/demo');
@kit.CalendarKit // 日历、日程、提醒管理
使用方式:添加日程、查询日程
示例:
import { calendar } from '@kit.CalendarKit';
calendar.insertEvent({ title: '会议' });
@kit.CloudFoundationKit // 云服务、云存储、文件同步
使用方式:云端文件上传、下载
示例:
import { cloud } from '@kit.CloudFoundationKit';
cloud.uploadFile('test.txt');
@kit.ContactsKit // 通讯录、联系人管理
使用方式:增删改查联系人
示例:
import { contacts } from '@kit.ContactsKit';
contacts.getContacts();
@kit.FileManagerServiceKit // 文件选择器、系统文件管理
使用方式:选择文件、打开文档
示例:
import { fileManager } from '@kit.FileManagerServiceKit';
fileManager.selectFile();
@kit.GameServiceKit // 游戏服务、防沉迷、成就
使用方式:游戏合规、成就系统
示例:
import { gameService } from '@kit.GameServiceKit';
gameService.checkAntiAddiction();
@kit.HealthServiceKit // 健康数据、步数、心率、睡眠
使用方式:获取健康运动数据
示例:
import { health } from '@kit.HealthServiceKit';
health.getStepCount();
@kit.IAPKit // 应用内购、付费、订阅
使用方式:道具购买、支付
示例:
import { iap } from '@kit.IAPKit';
iap.purchaseProduct('product_id');
@kit.LocationKit // 定位、经纬度、逆地理编码
使用方式:获取当前位置、持续定位
示例:
import { location } from '@kit.LocationKit';
location.getCurrentLocation((err, res) => {});
@kit.MapKit // 地图、POI、路线规划
使用方式:展示地图、标记点位
示例:
import { map } from '@kit.MapKit';
map.createMap().addMarker(lat, lng);
@kit.NotificationKit // 系统通知、状态栏消息、角标
使用方式:发送通知、取消通知
示例:
import { notification } from '@kit.NotificationKit';
notification.publish({ content: { title: '消息' } });
@kit.PaymentKit // 支付、收银台、订单交易
使用方式:发起支付、订单结算
示例:
import { payment } from '@kit.PaymentKit';
payment.pay({ orderId: '123', amount: 100 });
@kit.PDFKit // PDF预览、文档解析
使用方式:打开PDF、阅读文档
示例:
import { pdf } from '@kit.PDFKit';
pdf.openFile('test.pdf');
@kit.PreviewKit // 文件预览、多格式文档查看
使用方式:预览图片/文档/视频
示例:
import { preview } from '@kit.PreviewKit';
preview.openFile('doc.txt');
@kit.PushKit // 消息推送、离线推送、PushId
使用方式:注册推送、获取推送ID
示例:
import { push } from '@kit.PushKit';
push.getPushId().then((id) => {});
@kit.ShareKit // 系统分享、文本/图片/文件分享
使用方式:唤起分享面板
示例:
import { share } from '@kit.ShareKit';
share.share({ title: '分享', content: '内容' });
@kit.WalletKit // 钱包、卡包、交通卡、证件
使用方式:添加卡片、管理证件
示例:
import { wallet } from '@kit.WalletKit';
wallet.addCard({ cardId: '123' });
@kit.WeatherServiceKit // 气象数据、天气查询、预报服务
使用方式:获取实时天气、预报数据
示例:
import { weather } from '@kit.WeatherServiceKit';
weather.getCurrentWeather();
10. 行业专属扩展
@kit.CarKit // 车机、车载、车辆数据、行车状态 使用方式:获取车速、车况、车机控制 示例: import { car } from '@kit.CarKit'; car.getVehicleSpeed();@kit.EnterpriseSpaceKit // 企业工作空间、数据隔离
使用方式:双空间切换、数据防护
示例:
import { enterpriseSpace } from '@kit.EnterpriseSpaceKit';
enterpriseSpace.switchSpace();
@kit.GameControllerKit // 游戏手柄、外设控制
使用方式:连接手柄、监听按键
示例:
import { gameController } from '@kit.GameControllerKit';
gameController.connect();
@kit.LiveViewKit // 实况图片、动态壁纸
使用方式:设置动态壁纸、实况图
示例:
import { liveView } from '@kit.LiveViewKit';
liveView.setWallpaper();
@kit.ReaderKit // 电子书、文档阅读引擎
使用方式:打开电子书、解析文档
示例:
import { reader } from '@kit.ReaderKit';
reader.openBook('book.epub');
@kit.ScenarioFusionKit // 场景融合、智能场景触发
使用方式:自动场景、智能联动
示例:
import { scenario } from '@kit.ScenarioFusionKit';
scenario.on('scene_change', () => {});
@kit.ScreenTimeGuardKit // 设备使用时长、健康使用
使用方式:获取使用时长、限制使用
示例:
import { screenTime } from '@kit.ScreenTimeGuardKit';
screenTime.getUsageTime();
@kit.ScanKit // 扫码、二维码、条形码识别
使用方式:开启扫码、解析条码
示例:
import { scan } from '@kit.ScanKit';
scan.startScan(context, (res) => {});
更多推荐



所有评论(0)