首页
学习
活动
专区
圈层
工具
发布

你会了吗 HarmonyOS Next 项目级别的注释规范

HarmonyOS Next 项目级别的注释规范 程序员箴言 我最讨厌世界上的两种人: 第一种是不写注释的人 第二种是让我写注释的人 前言 随着HarmonyOS NEXT的发展加快,不少的公司已经陆续加大了资源来开发软件项目...那么伴随项目的发展,项目团队也需要按照一定 的规范来编写项目注释或者代码的说明文档。 我认为编写项目注释或者代码的说明文档最小的代价就是 直接通过编写注释的方式来实现代码的使用文档。...jsDoc提供了对 常量、类、函数、接口、枚举等的修饰符,一般情况下不需要主动添加,因为 DevEco Studio 可以自动识别 @constant @class @function @interface...如我们想要给 Person添加一些备注说明,那么我们不能使用以下这种注释 // 这个单行注释不行 /* 这个普通的多行注释也不行 */ 我们只能使用这种 /** * 这个是OK的 */ 你可以在想要修饰的代码上方...输入 /** + tab 开快速生成 在带有参数的函数上方,它会自动添加参数的修饰符,包括返回值 @param 和 @returns @param 修饰函数的形参 @returns 修饰返回值

31400
  • 您找到你想要的搜索结果了吗?
    是的
    没有找到

    分享几个便利的工具软件

    clover 官方网址:http://cn.ejie.me/ 方便的 Tab 页功能 要掌握功能强大,操作简单的标签页,只需记住Ctrl+T新开页面,Ctrl+W关闭页面,Ctrl+Tab切换页面,工作效率提高何止一倍...操作系统无缝集成 Clover 通过插件的形式集成到 Windows Explorer,保留您通常的使用习惯,无需学习新的文件管理操作,马上就可以使用啦。...快如闪电的书签栏 按Ctrl+D添加当前路径,或者直接将文件夹拖入书签栏。再也不用到处寻找要访问的文件夹了,瞬间到达,何等痛快! ?...Zeal 官方地址:https://zealdocs.org/ 离线API文档工具,在zeal中可以快速的查找一些语言的函数和模块名称,像图中这样子的,具体的使用可以参考官网的说明,目前主流的框架和语言都有支持...GitKraken 官方地址:https://www.gitkraken.com/ 比较好用的git可视化工具,一键取消,比较好的合并工具,支持git子项目。 ?

    1.1K60

    分享几个便利的工具软件

    本文作者:IMWeb 黄龙 原文出处:IMWeb社区 未经同意,禁止转载 clover 官方网址:http://cn.ejie.me/ 方便的 Tab 页功能 要掌握功能强大,操作简单的标签页...操作系统无缝集成 Clover 通过插件的形式集成到 Windows Explorer,保留您通常的使用习惯,无需学习新的文件管理操作,马上就可以使用啦。...快如闪电的书签栏 按Ctrl+D添加当前路径,或者直接将文件夹拖入书签栏。再也不用到处寻找要访问的文件夹了,瞬间到达,何等痛快! ?...Zeal 官方地址:https://zealdocs.org/ 离线API文档工具,在zeal中可以快速的查找一些语言的函数和模块名称,像图中这样子的,具体的使用可以参考官网的说明,目前主流的框架和语言都有支持...GitKraken 官方地址:https://www.gitkraken.com/ 比较好用的git可视化工具,一键取消,比较好的合并工具,支持git子项目。 ?

    1.1K20

    Clover引导简明教程

    -64.efi 部分机型可能会需要(可选) Clover Bootloader详解 本节会详细介绍Clover各项功能的用法 Clover主界面 使用Clover开机引导后,默认的系统界面如下: 本例中...所有的选项都在这个菜单里,当你无法引导进入 macOS 系统使用 Clover Configurator 进行选项调整时,可以通过该选项进行修改进入系统。...比如前面教大家的使用 -v 打开啰嗦模式,就是通过它传递的;再比如你使用了不兼容版本的 Lilu 和 AppleALC 而导致无法进入系统时,可以在这上面手动添加上: -liluoff 或者 -alcoff...AddPNLF 添加一个非常实用的PNLF 设置代码:当然只有你可以调节亮度控制时才有用。...这个浮动的区域导致无法使用自定义DSDT(custom DSDT),因为这个区域可移动且不符合当前的状态。这个补丁的目的是找到BIOS中所有这样的区域并在自定义DSDT中加以修正。

    19.2K32

    Swift开发规范

    文件名如果有复数含义,文件名应使用复数形式,如一些工具类; 修饰规约 能用 let 修饰的时候,不要使用 var; 修饰符顺序按照 注解、访问限制、static、final 顺序; 尽可能利用访问限制修饰符控制类...,特殊场景除外,如构造函数时 当方法无返回值时,不需添加 void 注释规约 文档注释使用单行注释,即///,不使用多行注释,即/***/。...尽可能少的使用全局命名空间,如常量、变量、方法等 赋值数组、字典时每个元素分别占用一行时,最后一个选项后面也添加逗号;这样未来如果有元素加入会更加方便 布尔类型属性使用 is 作为属性名前缀,返回值为布尔型类型的方法名使用...工具 提示并修复格式错误 两者大部分格式规范都是一致的,少许规范不一致,两个工具之间使用不冲突,可以在项目中共存。...我们通过配置文件可以控制启用或者关闭相应的规则,具体使用规则参照对应仓库的 REAMME.md 文件。 相关规范 Swift 官方 API 设计指南 Google 发布的 Swift 编码规范

    2K10

    黑苹果安装指南

    EFI文件准备 这个是安装黑苹果最关键的一步了,对于不会搞的人来说,最好的方法是网上找别人已经配置好的EFI文件,这里推荐的是从Github上人家整理好的EFI项目中下载,这里使用的引导方式是Clover...有一个问题:Github仓库是无法直接单独下载项目中的某个文件夹,你只能下载全部内容然后找到所需要的Clover文件夹。...而且这里提供的Clover是难以安装最新的Mojave系统的(瞎说的,只是因为我没有成功)。...添加开机启动引导 工具:EasyUEFI 使用方法: 右键EasyUEFI,选择以管理员身份打开; 点击右侧第二个图标,有个+号; 点击新的300M的EFI分区,在type中选择Linux...拷贝EFI文件到U盘 依然是使用DiskGnius来进行操作,你上一步制作好的U盘自带EFI分区,你只需要将原来Clover的删除,将你之前下载的Clover文件复制进去就好了。

    2.5K10

    Gradle 学习 ----Gradle 与Idea整合

    如下图所示 : 下载别人的项目或者使用操作以前自己写的不同版本的gradle项目时:用Gradlewrapper,也即:gradlew 什么时候使用本地gradle?...Groovy中的类型有 : 1 .原生数据类型及包装类 2 .类、内部类、抽象类、接口 3 .注解 4 .Trait:可以看成是带有方法实现的接口 权限修饰符 :public、protected、...2. 4. 5 、案例 5 :集合操作 Groovy支持List、Map集合操作,并且拓展了Java中的API,具体参考如下方法: List: add() 添加某个元素 plus() 添加某个list...第二步:修改当前项目使用本地安装的gradle:可以加快下载项目依赖jar包的速度【配置了私服地址】。...web工程 在idea新版本的创建项目中,无法自己选择创建项目是普通java工程还是web工程了【IDEA旧版本是可以的】,所以我们如果想创建web工程,只需要自己在src/main/目录下添加webapp

    1.4K00

    Clover 引导器.配置助手

    boot into 10.4 – 10.9 OSX, Windows EFI and Linux EFI – EFI bootloader 提供 OS 运行 RuntimeServices (传统引导器无法提供...参数 (Clover Rev 2789+) > 修复以前版本一些错误 4.10.0版 > 在Boot模块下,使用CustomLogo替换UseCustomLogo, UseAlternateLogo...参数 (clover 2759 +) > 在GUI 模块-> Custom Entries 项加入CustomLogo参数 > 在Device模块的Audio 项里添加AFGLowPowerState...▼ Clover官方使用问题反馈 反馈 >>前往 (注意使用用英文反馈问题) 请确保clover引导时开启日志保存功能,如有故障请跟贴上传boot.log(启动日志)!...你的反馈将有助于clover不断改进! ▼ Clover Helper [自动显示Clover版本更新内容] 很方便实用的Clover最新更新内容查询工具。

    1.7K20

    如何在VirtualBox中运行macOS Catalina Beta版本

    Clover,包括SIP启用或SIP禁用版本,并且整个操作过程都是关于在1280×1024中运行Catalina的(如果你想更改它,请参阅此处有关自定义Clover的文章 - >https://astr0baby.wordpress.com...这里我们使用一个小技巧来修复“cannot move windows in Catalina VM”这个问题,如果你只使用本地VirtualBox鼠标,那么我们将插入一个真正的辅助USB鼠标,并将其添加到...创建Catalina VirtualBox环境后(请确保你已按照以上截图进行设置,否则它将无法工作)我们将以下的Shell脚本应用于VirtualBox Catalina Guest(将其另存为catalina.sh...现在,你会发现在Catalina guest中有两个鼠标可用,使用我们在VirtualBox USB Pass-through中选择的USB鼠标 P.S 在缩放模式下,Clover菜单由于某种原因无法正常工作...,并且无法移动方向键来选择启动,因此在启动Catalina时不要使用缩放模式,你可以在启动后立即将其更改为缩放模式) 如要对系统进行更新升级,你只需在下次macOS获得系统更新时,选择Clover中的安装程序分区即可

    2.9K20

    【Share】Dell Precision 5510 Mojave Clover分享

    ---- 镜像写入 既然你来到了这一步 希望你能坚持安装完 我相信这一定是有趣的一段历程 我所使用的镜像是macOS Mojave 10.14.1 18B75 Clover 4726原版镜像 当然 保险起见...写完镜像之后,U盘会变成两个分区,一个叫EFI的就是U盘引导区,里面存在镜像自带的Clover;另外一个叫U盘的提示你未格式化,这个时候千万不要手贱去格式化,这是因为Windows无法识别Mac的文件格式...进入安装界面后,你可以用磁盘工具对你的SSD进行分区,目前我的5510的固态全部分给MacOS使用。...重启后,再进入系统偏好设置-网络,点击左下角的加号,先添加WiFi,再添加蓝牙,然后应用,就可以了。...X64 10.14 EFI VerbStub Clover r4769 Clover Configurator 5.3.1.0 ---- 最后 到这里为止 整个教程也算告一个段落了 目前的版本已经可以满足你的日常功能使用

    6K20

    杂项-黑苹果安装教程「建议收藏」

    步骤 下载好需要的工具 TransMac(win下使用,文末第一条参考链接里有下载地址,我是自己下载的11.5版本) 台式机万能 Clover 5093 通用EFI(文末第一条参考链接里有下载地址)...macOS Mojave_XXX.dmg(Mac系统镜像,我用的黑果小兵原版镜像10.14.6) Clover Configurator.app(Mac下使用,自行下载) 在win下先插入U盘 我遇到的坑...:USB2.0的U盘就插3.0口,后续TransMac报错,始终无法操作U盘,换到USB2.0口解决。...Lilu.kext黑苹果驱动扩展补丁各个版本合集 解决方案二: 添加clover的启动参数添加 : -no_compat_check或者在clover界面按O,找到smbios,第一行敲回车修改机型...进入Mac系统后安装“Clover Configurator.app”,然后打开后点击挂载分区,选择U盘的EFI分区并且打开它,然后把你下载好的EFI复制进去,我使用的是“台式机万能 Clover 5093

    6.1K11

    YC最新DemoDay上的21个AI项目,我们盘点了一遍 | 创业必读

    这批103个项目从7200多家创业公司中挑选而来,来自22个国家和地区。 根据量子位的统计,此次DemoDay共有21个人工智能创业项目。...以下是这21个AI创业项目: Vinsight(农作物产量预测) ? Vinsight使用机器学习、卫星图像、天气数据和历史报告来预测农作物的产量,号称比其他方式好四倍。...因为缺乏准确的预测,美国农民往往签下无法兑现的大单,导致每年损失110亿美元。...Clover能够对语音交互进行分析,并提供相关的销售策略建议。Clover能够识别销售是否只顾着介绍产品性能而不是功能,或者销售在错误的时间结束了沟通。...NanoNets提供的API能帮助任何企业轻松使用机器学习。上传数据,等待10分钟,再添加几行代码,企业就可以查看机器学习带来的数据挖掘结果,例如识别照片中鞋子的品牌。

    2.4K70

    Dart 语法基础

    Dart 注释Dart 支持单行注释、多行注释和文档注释。单行注释单行注释以 // 开头。 // 和行尾之间的所有内容都被 Dart 编译器忽略。...方括号中的名称在已记录程序元素的词法作用域中解析。这是一个带有对其他类和参数引用的文档注释示例:/// 一种驯养的南美骆驼科动物(羊驼)。...要解析 Dart 代码并生成 HTML 文档,您可以使用 Dart 的文档生成工具, dart doc 。有关生成的文档示例,请参见Dart API 文档。...Dart 库与导入import 和 library 指令可以帮助您创建模块化且可共享的代码库。库不仅提供 API,而且还是隐私单元:以下划线 (_) 开头的标识符仅在库内可见。...注意要了解为什么 Dart 使用下划线而不是 public 或 private 等访问修饰符关键字,请参阅SDK issue 33383 。

    71310

    01.C++基础语法

    支持最新的 C++ 标准。提供强大的调试和开发工具。安装:通过 Visual Studio 安装。使用:在 Visual Studio 中创建项目并编译。...下一行 using namespace std; 告诉编译器使用 std 命名空间。命名空间是 C++ 中一个相对新的概念。下一行 // main() 是程序开始执行的地方 是一个单行注释。...使用文档注释生成 API 文档,常用的工具包括:Doxygen:https://www.doxygen.nl/Sphinx...这样,编译器就无法判断您所使用的是哪一个 xyz() 函数。解决办法:因此,引入了命名空间这个概念,可作为附加信息来区分不同库中相同名称的函数、类、变量等。使用了命名空间即定义了上下文。...hh:在某些项目中也会使用,通常是 UNIX 或 Linux 社区的风格。.tpp:用于模板类或函数的实现文件(通常与 .hpp 配合使用)。

    30910

    史上最全的黑苹果系统「MacOS」安装教程,小白也能秒掌握!

    (1).原版:基于官方镜像制作的镜像(后缀名.dmg),集成了 Clover 或者 Opencore 的引导,可以直接通过 TransMac 软件写入 U 盘,这类镜像比较纯净,安装后体验更好,这里推荐使用黑果小兵大大的镜像...一般带有独显的笔记本在macOS下都是不能驱动的,除非出厂屏蔽了 CPU 的核显或者能够在 Bios 设置中屏蔽核显,不然在 macOS 下只能驱动核显 (关于核显的驱动: https://blog.daliansky.net...(2).AMD:因为架构的不同,macOS 原生的内核无法支持,所以要下载别人改好的镜像,比较麻烦,然后在安装时也要替换内核文件。太过复杂,我就不再赘述了。...CodecCommander 驱动 CodecCommander.kext 耳机有杂音、睡眠唤醒无法自动切换或无声 9....若你是单硬盘双系统,将 EFI 文件夹中的 Clover 文件夹放入硬盘 EFI 分区的 EFI 文件夹中,然后进入 windows 中,下载 EasyUEFI 软件,添加 Clover 启动项(详细方法百度

    34.7K33

    集成测试 Cypress 配置

    之前小伙伴写了一个性能上报的 SDK,近期做重构了之后要兼容 script import 方式的引入,同时还要引入 Google 新推出的性能衡量指标,肉眼可见随着该项目的发展,项目体积、文件数量都会与日俱增...在此大背景下,我尝试了 Cypress 添加了集成测试。 单元测试 & 集成测试 单测集中于系统内部各个子模块的健壮,而集成测试则侧重于项目的整体运行状况。...特别是某些模块依赖于环境(浏览器),虽然单测也可以做,但是比较麻烦,需要宿主环境下的必要参数,比如需要 performance api。...的配置,在 env 的层级下,因为我们只需要在测试环境使用到。...scripts 中添加启动命令: "test:e2e": "cross-env NODE_ENV=test cypress open" NODE_ENV 使用后,上述 .babelrc 的配置才能生效

    1.3K10

    黑苹果安装手记(二)

    此时最好再打开硬盘的EFI文件夹,然后在相同目录复制一份Config.plist文件,万一重启出问题了进不了系统,可以在启动时的Clover引导界面,使用方向键选择Option/Config,然后选择你备份的...注意:使用万能声卡驱动的话,要在EFI/Clover/kexts/Other中要删除AppleACL.kext哦! ? 下面是使用注入声卡ID的方式,如果万能声卡驱动不能用,就看看这个吧。...如果没有,就打开EFI/Clover/kexts/Other目录中的文件说明.md(使用文本编辑打开)文件找到对应自己有线网卡驱动的文件名称,从Backup文件夹中复制一份到Other目录中,然后重启就可以了...无线网卡/蓝牙 无线网卡在上一篇文章中已经提过,大多数的笔记本内置网卡都无法在黑苹果中使用,只能购买免驱动的内置网卡,然后更换即可,或者购买USB免驱动的那种。然后开机就有wifi啦!...屏幕亮度调节 CloverConfigurator挂载硬盘EFI分区,然后加载Config.plist文件,选择ACPI设置,在Fixes的第二页,勾上添加PNLF,然后保存配置文件,重启就可以控制亮度啦

    2.9K30
    领券