Awesome

<div align="center"> <p> <img src="https://s1.imagehub.cc/images/2023/03/24/c5f6f649b6ed3aae341966a92fca2747.md.png" alt="autojs6-ts-declarations-banner_1024×310" border="0" width="496" /> </p> <p>AutoJs6 声明文件 (d.ts)</p> <p>TypeScript Declarations for AutoJs6</p> <p> <a href="http://dts-project.autojs6.com/blob/main/package.json"><img alt="Version name" src="https://img.shields.io/badge/dynamic/json?color=534BAE&label=version&query=%24.version&url=https%3A%2F%2Fraw.githubusercontent.com%2FSuperMonster003%2FAutoJs6-TypeScript-Declarations%2Fmaster%2Fpackage.json"/></a> <a href="http://dts-issues.autojs6.com"><img alt="GitHub issues" src="https://img.shields.io/github/issues/SuperMonster003/AutoJs6-TypeScript-Declarations?color=009688"/></a> <a href="http://project.autojs6.com"><img alt="GitHub AutoJs6 repository" src="https://img.shields.io/badge/autojs6->=6.3.3-388E3C"/></a> <a href="https://github.com/topics/javascript"><img alt="GitHub top language" src="https://img.shields.io/github/languages/top/SuperMonster003/AutoJs6-TypeScript-Declarations?color=3178C6"/></a> <br> <a href="https://github.com/SuperMonster003/AutoJs6-TypeScript-Declarations/commit/f8250babdb161e12ad2e14c73e8aa2b5d7d89cbc"><img alt="Created" src="https://img.shields.io/date/1635813883?color=C56000&label=created"/></a> <a href="https://github.com/SuperMonster003/AutoJs6-TypeScript-Declarations/blob/main/LICENSE"><img alt="GitHub License" src="https://img.shields.io/github/license/SuperMonster003/AutoJs6-TypeScript-Declarations?color=C63F17"/></a> <a href="https://github.com/SuperMonster003/AutoJs6-TypeScript-Declarations/find/master"><img alt="GitHub Code Size" src="https://img.shields.io/github/languages/code-size/SuperMonster003/AutoJs6-TypeScript-Declarations?color=795548"/></a> <a href="https://www.jetbrains.com/?from=AutoJs6-TypeScript-Declarations"><img alt="JetBrains supporter" src="https://img.shields.io/badge/supporter-JetBrains-ee4677"/></a> </p> </div>

功能简介

实现或增强开发工具的代码智能补全功能:

AutoJs6 版本: 不低于 6.3.3
支持的开发工具: VSCode / WebStorm / HBuilderX ...

样例展示

<details><summary>点击展开或收起样例展示</summary> <div align="center"> <br> <img src="https://s1.imagehub.cc/images/2023/03/24/3bbae966e4c0cbe611de7cf9dffb8150.gif" alt="autojs6-ts-declarations-demo" border="0"/> </div> </details>

使用说明

[ 1 ] - 获取声明文件 (d.ts) 的主目录

可以从 NPM 或 GitHub 获取主目录.

从 NPM 获取 (推荐)

npm i @sm003/autojs6-dts

安装后, 定位到 /node_modules/@sm003/autojs6-dts/declarations.

从 GitHub 获取

下载最新项目 zip 数据包, 解压后得到 declarations 文件夹.

[ 2 ] - 放置声明文件的主目录

如使用 WebStorm, 此步骤可略过.

假设用户有一个名为 hello 的项目, 项目目录结构如下:

hello / images / ...
hello / docs / ...
hello / main.js
hello / project.json
... ...

则 declarations 主目录支持以下方式放置:

hello / declarations / (推荐)
hello / images / declarations /
hello / docs / declarations /
hello / ... / ... / declarations /

但不能放置在项目的同级或上级目录中.

[ 3 ] - 实现或增强代码智能补全

开发工具会自动识别并开始索引所有声明文件.

索引完成后开始编写代码并体验代码智能提示.

注: 部分编辑器可能需要重新启动才能开始声明文件的索引.

[ 4 ] - VSCode 编辑器的额外配置

VSCode 可能无法像 WebStorm 一样识别任意位置的 declarations 文件夹, 尤其是使用 npm 命令部署后, declarations 文件夹更是难以被 VSCode 默认识别. 因此需要将 jsconfig.json 文件复制到项目根目录中, 如:

hello / mode_modules / @sm003 / autojs6-dts / ...
hello / jsconfig.json
hello / main.js
... ...

如果项目中本身已存在 jsconfig.json 文件, 只需将下列配置合并到已有文件即可:

{
  "compilerOptions": {
    "typeRoots": [
      "./node_modules/@sm003/autojs6-dts/declarations",
      "./declarations"
    ]
  }
}

重启 VSCode 后, 示例中的 hello/main.js 可实现或增强代码智能补全.

获取更新

从 NPM 直接获取更新:

npm update @sm003/autojs6-dts

如需检查更新, 除直接到当前项目主页查看外, 还可定位到项目根目录的 package.json 文件, 鼠标悬停在 @sm003/autojs6-dts 依赖项的版本值处, 在浮动窗口中可查看是否存在版本更新. 另外 VSCode 也可借助 Version Lens 插件实现版本更新检查.

通常情况下, AutoJs6 发布版本更新后, 声明文件项目也会伴随更新.

版本历史

v2.1.3

2023/12/02

新增 opencc 模块声明文件
优化 完善 ocr 章节缺失的 detect 及 recognizeText 声明
优化 适配 AutoJs6 6.5.0
依赖 附加 Android OpenCC 声明文件版本 1.2.0
依赖 升级 Android dx 声明版本 1.11 -> 1.14
依赖 降级 Jackson DataBind 声明版本 2.14.3 -> 2.13.3
依赖 降级 Apache Commons IO 声明文件版本 2.14.0 -> 2.8.0

v2.1.2

2023/10/30

新增 shizuku 模块声明文件
新增 barcode 模块声明文件
新增 qrcode 模块声明文件
优化 适配 AutoJs6 6.4.0

v2.1.1

2023/07/21

优化 适配 AutoJs6 6.3.3

打赏 (Tip)

<details><summary>查看详情 (Click to show details)</summary><br> <div align="center"> To tip online, scan the QR code below <br> 扫描对应二维码可打赏 <br><br> I believe I could make it better with your support :) <br> 感谢每一份支持和鼓励 <br><br>

</div> </details>