HarmonyOS：创建应用静态快捷方式

一、前言

静态快捷方式是一种在系统中创建的可以快速访问应用程序或特定功能的链接。它通常可以在长按应用图标，以图标和相应的文字出现在应用图标的上方，用户可以迅速启动对应应用程序的组件。使用快捷方式，可以提高效率，节省了查找和打开对应的组件时间；也可以实现个性化定制的需求，创建多个快捷方式，以满足个性化的工作流程和操作偏好。应用配置静态快捷方式，在桌面上展示的效果如下图：

安装该应用后，在桌面上长按该应用图标，在应用的图标上方会出现开发者配置的快捷方式（“创建应用静态快捷方式详情”和“分享好友”），点击对应的标签，即可拉起对应的组件。

在这里插入图片描述

二、shortcuts标签

shortcuts标识应用的快捷方式信息。标签值为数组，包含四个子标签shortcutId、label、icon、wants。

metadata中指定shortcut信息，其中：

  • name：指定shortcuts的名称，使用ohos.ability.shortcuts作为shortcuts信息的标识。
  • resource：指定shortcuts信息的资源位置。

shortcuts标签说明

属性名称含义类型是否可缺省
shortcutId标识快捷方式的ID，取值为长度不超过63字节的字符串。不支持通过资源索引的方式（$string）配置该字段。字符串该标签不可缺省。
label标识快捷方式的标签信息，即快捷方式对外显示的文字描述信息。取值为长度不超过255字节的字符串，可以是描述性内容，也可以是标识label的资源索引。字符串该标签可缺省，缺省值为空。
icon标识快捷方式的图标，取值为资源文件的索引。字符串该标签可缺省，缺省值为空。
wants标识快捷方式内定义的目标wants信息集合，在调用launcherBundleManager的startShortcut接口时，会拉起wants标签里的第一个目标组件，推荐只配置一个wants元素。对象该标签可缺省，缺省为空。

三、配置方法

2.1 配置快捷方式的配置文件。

开发者若要配置静态快捷方式，可以在某个模块的/resources/base/profile/目录下配置快捷方式的配置文件，如shortcuts_config.json。

{
  "shortcuts": [
    {
      "shortcutId": "id_test1",  // 标识快捷方式，在应用有多个快捷方式时，该字段可作为快捷方式的唯一标识符
      "label": "$string:share",  // 标识该快捷方式对外显示的文字
      "icon": "$media:share_icon",  // 标识该快捷方式对外显示的图片
      "wants": [
        {
          "bundleName": "com.ohos.hello",   // 对应该快捷方式对应拉起组件的包名
          "moduleName": "entry",    // 对应该快捷方式对应拉起组件的模块名
          "abilityName": "EntryAbility",   // 对应该快捷方式对应拉起组件的组件名
          "parameters": {
            "testKey": "testValue"   // 表示拉起快捷方式时的自定义数据
          }
        }
      ]
    }
  ]
}

示例图

在这里插入图片描述

2.2 在应用module.json5文件中配置metadata指向快捷方式的配置文件。

在module.json5配置文件的abilities标签中，针对需要添加快捷方式的UIAbility进行配置metadata标签，使shortcut配置文件对该UIAbility生效。

{
  "module": {
  // ...
    "abilities": [
      {
        "name": "EntryAbility",
        "srcEntry": "./ets/entryability/EntryAbility.ets",
        // ...
        "metadata": [
          {
            "name": "ohos.ability.shortcuts",  // 配置快捷方式，该值固定为ohos.ability.shortcuts
            "resource": "$profile:shortcuts_config"  // 指定shortcuts信息的资源位置
          }
        ]
      }
    ]
  }
}

示例图

在这里插入图片描述

四、示例

效果图

在这里插入图片描述

示例代码

shortcuts_config.json

{
  "shortcuts": [
    {
      "shortcutId": "1",
      "label": "$string:create_short_cut_detail",
      "icon": "$media:icon_create_shortcut",
      "wants": [
        {
          "bundleName": "com.example.learnharmonyos",
          "moduleName": "entry",
          "abilityName": "ShortcutsEntryAbility",
          "parameters": {
            "pageType": "1"
          }
        }
      ]
    },
    {
      "shortcutId": "2",
      "label": "$string:share_friend",
      "icon": "$media:icon_share",
      "wants": [
        {
          "bundleName": "com.example.learnharmonyos",
          "moduleName": "entry",
          "abilityName": "ShortcutsEntryAbility",
          "parameters": {
            "pageType": "2"
          }
        }
      ]
    }
  ]
}

module.json5

 "abilities": [
      {
        "name": "EntryAbility",
        "srcEntry": "./ets/entryability/EntryAbility.ets",
        "description": "$string:EntryAbility_desc",
        "icon": "$media:layered_image",
        "label": "$string:EntryAbility_label",
        "startWindowIcon": "$media:startIcon",
        "startWindowBackground": "$color:start_window_background",
        "exported": true,
        "skills": [
          {
            "entities": [
              "entity.system.home"
            ],
            "actions": [
              "action.system.home"
            ]
          }
        ],
        "metadata": [
          {
            // 配置快捷方式，该值固定为ohos.ability.shortcuts
            "name": "ohos.ability.shortcuts",
            // 指定shortcuts信息的资源位置
            "resource": "$profile:shortcuts_config"
          }
        ]
      }
  ]

BackToHomeComponent.ets

import { common, Want } from '@kit.AbilityKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
import { BusinessError } from '@kit.BasicServicesKit';

const TAG: string = '[BackToHomeComponent]';
const DOMAIN_NUMBER: number = 0xFF00;


@Component
export struct BackToHomeComponent {
  pageName: string = ""

  build() {
    Button('回到首页')
      .fontColor($r('app.color.c_black'))
      .fontWeight(FontWeight.Medium)
      .fontSize(20)
      .padding(10)
      .onClick(() => {
        let context: common.UIAbilityContext = getContext(this) as common.UIAbilityContext; // UIAbilityContext
        // 在FuncAbility中通过调用terminateSelf()方法实现。
        // context为需要停止的UIAbility实例的AbilityContext
        let wantInfo: Want = {
          deviceId: '', // deviceId为空表示本设备
          bundleName: 'com.example.learnharmonyos',
          moduleName: 'entry', // moduleName非必选
          abilityName: 'EntryAbility',
          parameters: {
            // 自定义信息
            info: this.pageName
          },
        }
        context.startAbility(wantInfo).then(() => {
          hilog.info(DOMAIN_NUMBER, TAG, 'startAbility EntryAbility 首页 success.');
        }).catch((error: BusinessError) => {
          hilog.error(DOMAIN_NUMBER, TAG, 'startAbility EntryAbility 首页 failed.');
        })

        context.terminateSelf((err) => {
          if (err.code) {
            hilog.error(DOMAIN_NUMBER, TAG,
              `Failed to terminate self. Code is ${err.code}, message is ${err.message}`);
            return;
          }
        });
      })
  }
}

CreateShortCutInfo.ets

import { webview } from '@kit.ArkWeb'
import { BackToHomeComponent } from './BackToHomeComponent'

@Entry
@Component
struct CreateShortCutInfo {
  private webviewController: webview.WebviewController = new webview.WebviewController();
  private url: string =
    'https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/typical-scenario-configuration-V5'

  build() {
    Column({ space: 10 }) {
      BackToHomeComponent({ pageName: "CreateShortCutInfo" })
      Web({ src: this.url, controller: this.webviewController })
    }
    .height('100%')
    .width('100%')
  }
}

ShortCutShare.ets


import { BackToHomeComponent } from './BackToHomeComponent'

@Entry
@Component
struct ShortCutShare {
  @State message: string = '分享成功';

  build() {
    Column({ space: 10 }) {
      BackToHomeComponent({ pageName: "ShortCutShare" })

      Text(this.message)
        .fontSize(10)
        .fontWeight(FontWeight.Bold)
        .margin({ top: 20 })
    }
    .width('100%')
    .height('100%')
  }
}

ShortcutsEntryAbility.ets

import { AbilityConstant, UIAbility, Want } from '@kit.AbilityKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
import { window } from '@kit.ArkUI';

export default class ShortcutsEntryAbility extends UIAbility {
  shortcutsEntryAbilityWant: Want | undefined = undefined

  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
    hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onCreate');
    this.shortcutsEntryAbilityWant = want;
  }

  onDestroy(): void {
    hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onDestroy');
  }

  onWindowStageCreate(windowStage: window.WindowStage): void {
    // Main window is created, set main page for this ability
    hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onWindowStageCreate');
    let router = 'pages/shortcuts/CreateShortCutInfo'
    if (this.shortcutsEntryAbilityWant?.parameters?.pageType &&
      this.shortcutsEntryAbilityWant?.parameters?.pageType === '2') {
      router = 'pages/shortcuts/ShortCutShare'
    }
    windowStage.loadContent(router, (err) => {
      if (err.code) {
        hilog.error(0x0000, 'testTag', 'Failed to load the content. Cause: %{public}s', JSON.stringify(err) ?? '');
        return;
      }
      hilog.info(0x0000, 'testTag', 'Succeeded in loading the content.');
    });
  }

  onWindowStageDestroy(): void {
    // Main window is destroyed, release UI related resources
    hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onWindowStageDestroy');
  }

  onForeground(): void {
    // Ability has brought to foreground
    hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onForeground');
  }

  onBackground(): void {
    // Ability has back to background
    hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onBackground');
  }
}

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

如若内容造成侵权/违法违规/事实不符，请联系我们进行投诉反馈qq邮箱809451989@qq.com，一经查实，立即删除！

相关文章

从表人的相关单词聊起

从表人的相关单词聊起

英文单词是繁多的，甚至海量的，这和老外的思维方式有关，他们通常会为同一类事物的具体的东西或子类事物也专门创建一个单词来进行表达、表示或应对，这增加了表达的直接性和精确性，但是，也轻而易举地就创建出…
阅读更多...
低代码系统-产品架构案例介绍、轻流（九）

低代码系统-产品架构案例介绍、轻流（九）

轻流低代码产品定位为零代码产品，试图通过搭建来降低企业成本，提升业务上线效率。 依旧是从下至上，从左至右的顺序 名词概述运维层底层系统运维层，例如上线、部署等基础服务体系内置的系统能力，发消息、组织和权限是必…
阅读更多...
2025年美赛B题-结合Logistic阻滞增长模型和SIR传染病模型研究旅游可持续性-成品论文

2025年美赛B题-结合Logistic阻滞增长模型和SIR传染病模型研究旅游可持续性-成品论文

模型设计思路与创新点： 建模的时候应该先确定我们需要建立什么类的模型？优化类还是统计类？这个题需要大量的数据分析，因此我们可以建立一个统计学模型。 统计学建模思路：观察规律，建立模型，参…
阅读更多...
自由学习记录（32）

自由学习记录（32）

文件里找到切换颜色空间 fgui中的 颜色空间是一种总体使用前的设定 颜色空间，和半透明混合产生的效果有差异，这种问题一般可以产生联系 动效就是在fgui里可以编辑好，然后在unity中也准备了对应的调用手段，可以详细的使用每一个具…
阅读更多...
【2025AI发展预测】2.2025的风口与发展，我们如何主动拥抱这一浪潮

【2025AI发展预测】2.2025的风口与发展，我们如何主动拥抱这一浪潮

个人主页：Icomi 大家好我是一颗米，本系列文章包含我个人的一些思考见解，以及在网上看到的相关资讯，结合本人的认识，在那基础上进行加工输出，希望能帮助到各位，若您对本系列感兴趣，欢…
阅读更多...
操作系统(Linux Kernel 0.11Linux Kernel 0.12)解读整理——内核初始化(main init)之硬盘初始化

操作系统(Linux Kernel 0.11Linux Kernel 0.12)解读整理——内核初始化(main init)之硬盘初始化

前言 对硬盘和软盘块设备上数据的读写操作是通过中断处理程序进行的。内核每次读写的数据量以一个逻辑块(1024 字节)为单位，而块设备控制器则是以扇区(512字节)为单位访问块设备。在处理过程中，内核使用了读写请求项等待队列来顺序地缓冲一次读写多个逻…
阅读更多...
利用机器学习创建基于位置的推荐程序

利用机器学习创建基于位置的推荐程序

推荐系统被广泛应用于不同的应用程序中，用于预测用户对产品或服务的偏好或评价。在过去的几分钟或几小时里，你很可能在网上遇到过或与某种类型的推荐系统进行过互动。这些推荐系统有不同的类型，其中最突出的包括基于内容的过滤和协作过滤。在…
阅读更多...
【AI论文】Video-MMMU：评估从多学科专业视频中获取知识的能力

【AI论文】Video-MMMU：评估从多学科专业视频中获取知识的能力

摘要：人类通过三个认知阶段获取知识：感知信息、理解知识以及运用知识解决新问题。视频作为这一学习过程的有效媒介，促进了这些认知阶段的逐步推进。然而，现有的视频基准测试未能系统地评估大型多模态模型（LMMs&#xf…
阅读更多...
【C++高并发服务器WebServer】-9：多线程开发

【C++高并发服务器WebServer】-9：多线程开发

本文目录 一、线程概述1.1 线程和进程的区别1.2 线程之间共享和非共享资源1.3 NPTL 二、线程操作2.1 pthread_create2.2 pthread_exit2.3 pthread_join2.4 pthread_detach2.5 patch_cancel2.6 pthread_attr 三、实战demo四、线程同步五、死锁六、读写锁七、生产消费者模型 一、…
阅读更多...
C语言学习强化

C语言学习强化

前言 数据的逻辑结构包括： 常见数据结构： 线性结构：数组、链表、队列、栈 树形结构：树、堆 图形结构：图 一、链表 链表是物理位置不连续，逻辑位置连续 链表的特点： 1.链表没有固定的长度…
阅读更多...
【C++探索之路】STL---string

【C++探索之路】STL---string

走进C的世界，也意味着我们对编程世界的认知达到另一个维度，如果你学习过C语言，那你绝对会有不一般的收获，感受到C所带来的码云风暴~ ---------------------------------------begin--------------------------------------- 什么是…
阅读更多...
【WebRTC - STUN/TURN服务 - COTURN配置】

【WebRTC - STUN/TURN服务 - COTURN配置】

在WebRTC中，对于通信的两端不在同一个局域网的情况下，通信两端往往无法P2P直接连接，需要一个TURN中继服务，而中继服务可以选用 COTURN 构建。 注：COTURN 是一个开源的 TURN（Traversal Using Relays around…
阅读更多...
React 前端框架实战教程

React 前端框架实战教程

📝个人主页🌹：一ge科研小菜鸡-CSDN博客 🌹🌹期待您的关注 🌹🌹 引言 React 是由 Facebook 开发的前端 JavaScript 库，旨在构建高效、灵活的用户界面，尤其适用于单页应用…
阅读更多...
MiniMax-01中Lightning Attention的由来（线性注意力进化史）

MiniMax-01中Lightning Attention的由来（线性注意力进化史）

目录 引言原始注意力线性注意力因果模型存在的问题累加求和操作的限制Lightning AttentionLightning Attention-1Lightning Attention-2 备注 引言 MiniMax-01: Scaling Foundation Models with Lightning Attention表明自己是第一个将线性注意力应用到如此大规模的模型&#…
阅读更多...
互联网医院成品|互联网医院软件源码

互联网医院成品|互联网医院软件源码

互联网医院系统带来的好处是显而易见的，其通过先进的互联网技术为医疗行业带来了巨大的变革。以下将从多个方面详细阐述其带来的益处。 一、便捷的医疗服务 互联网医院系统为患者提供了更为便捷的医疗服务。患者无需再亲自前往医院，只需通过电脑、手机等…
阅读更多...
unity学习20：time相关基础 Time.time 和 Time.deltaTime

unity学习20：time相关基础 Time.time 和 Time.deltaTime

目录 1 unity里的几种基本时间 1.1 time 相关测试脚本 1.2 游戏开始到现在所用的时间 Time.time 1.3 时间缩放值 Time.timeScale 1.4 固定时间间隔 Time.fixedDeltaTime 1.5 两次响应时间之间的间隔：Time.deltaTime 1.6 对应测试代码 1.7 需要关注的2个基本…
阅读更多...
Centos7系统php8编译安装ImageMagick/Imagick扩展教程整理

Centos7系统php8编译安装ImageMagick/Imagick扩展教程整理

Centos7系统php8编译安装ImageMagick/Imagick扩展教程整理 安装php8安装ImageMagick1、下载ImageMagick2、解压并安装3、查看是否安装成功 安装imagick扩展包 安装php8 点我安装php8 安装ImageMagick 1、下载ImageMagick wget https://www.imagemagick.org/download/ImageMa…
阅读更多...
RabbitMQ模块新增消息转换器

RabbitMQ模块新增消息转换器

文章目录 1.目录结构2.代码1.pom.xml 排除logging2.RabbitMQConfig.java3.RabbitMQAutoConfiguration.java 1.目录结构 2.代码 1.pom.xml 排除logging <?xml version"1.0" encoding"UTF-8"?> <project xmlns"http://maven.apache.org/PO…
阅读更多...
Linux——网络基础（1）

Linux——网络基础（1）

文章目录 目录 文章目录 前言 一、文件传输协议 应用层 传输层 网络层 数据链路层 数据接收与解封装 主机与网卡 数据传输过程示意 二、IP和MAC地址 定义与性质 地址格式 分配方式 作用范围 可见性与可获取性 生活例子 定义 用途 特点 联系 四、TCP和UDP协…
阅读更多...
SpringBoot+Electron教务管理系统 附带详细运行指导视频

SpringBoot+Electron教务管理系统 附带详细运行指导视频

文章目录 一、项目演示二、项目介绍三、运行截图四、主要代码1.查询课程表代码2.保存学生信息代码3.用户登录代码 一、项目演示 项目演示地址&#xff1a; 视频地址 二、项目介绍 项目描述&#xff1a;这是一个基于SpringBootElectron框架开发的教务管理系统。首先&#xff…
阅读更多...
最新文章

Copyright @ 2022~2023