AutoJs6

- Overview - 综述
- About - 关于文档
- Progress - 文档部署进度
- Changelog - 文档更新日志

- Manual - AutoJs6 使用手册
- Q & A - 疑难解答

- Global - 全局对象
- Automator - 自动化
- AutoJs6 - 本体应用
- App - 通用应用
- Color - 颜色
- Image - 图像
- OCR - 光学字符识别
- Keys - 按键
- Device - 设备
- Storage - 储存
- File - 文件
- Engine - 引擎
- Task - 任务
- Module - 模块
- Plugins - 插件
- Toast - 消息浮动框
- Notice - 消息通知
- Console - 控制台
- Shell
- Media - 多媒体
- Sensor - 传感器
- Recorder - 记录器
- Timer - 定时器
- Thread - 线程
- Continuation - 协程
- Event - 事件监听
- Dialog - 对话框
- Floaty - 悬浮窗
- Canvas - 画布
- UI - 用户界面
- Web - 万维网
- HTTP
- Base64
- Crypto - 密文
- Internationalization - 国际化
- Standardization - 标准化
- E4X

- UiSelector - 选择器
- UiObject - 控件节点
- UiObjectCollection - 控件集合
- UiObjectActions - 控件节点行为
- ImageWrapper - 包装图像类
- App - 应用枚举类
- Color - 颜色类
- Version - 版本工具类
- Polyfill - 代码填泥
- Arrayx - Array 扩展
- Numberx - Number 扩展
- Mathx - Math 扩展

- Exceptions - 异常
- Intent - 意图
- Runtime - 运行时
- Context - 上下文
- Activity - 活动

- Scripting Java - 脚本化 Java
- Android API Level - 安卓 API 级别
- Color Table - 颜色列表

- Glossaries - 术语
- HttpHeader - HTTP 标头
- HttpRequestMethods - HTTP 请求方法
- MimeType - MIME 类型
- NotificationChannel - 通知渠道

- Data Types - 数据类型
- Omnipotent Types - 全能类型
- Storage - 存储类
- AndroidBundle
- AndroidRect
- CryptoCipherOptions
- CryptoKey
- CryptoKeyPair
- ConsoleBuildOptions
- HttpRequestBuilderOptions
- HttpRequestHeaders
- HttpResponseBody
- HttpResponseHeaders
- HttpResponse
- InjectableWebClient
- InjectableWebView
- NoticeOptions
- NoticeChannelOptions
- NoticePresetConfiguration
- NoticeBuilder
- Okhttp3HttpUrl
- OcrOptions
- Okhttp3Request
- OpencvPoint
- OpencvRect
- OpencvSize

- GitHub - 应用项目地址
- GitHub - 文档项目地址

# Base64#

Base64 是一种编码方式, 同时可作为一种数据的存储格式, 并非严格意义上的加密与解密.

base64 模块主要用于对数据进行 Base64 编码及解码.

> 注: 与 crypto 模块不同, crypto 模块主要用于信息的加密与解密.

> 参阅:
> Wikipedia (英) / Wikipedia (中)
> Base64 笔记 (from 阮一峰的网络日志)
> Base64 是加密算法吗 (from 稀土掘金)

## 可逆性#

Base64 是一种可逆的编码方式:

    console.log(base64.decode(base64.encode('orange'))); // orange
    console.log(base64.decode(base64.encode('简体中文'))); // 简体中文

但需注意参数的字符编码方式 (默认为 `UTF-8`), 当存在超出编码表示范围的字符时, 可逆性将遭到破坏:

    /* us-ascii 编码无法表示 "出" 和 "口". */
    console.log(base64.decode(base64.encode('E2 出口', 'us-ascii'), 'us-ascii')); // E2 ??

编解码使用了不同的编码方式, 也可能导致可逆性失效:

    /* utf-16 与 utf-8 不一致. */
    console.log(base64.decode(base64.encode('简体中文', 'utf-16'), 'utf-8')); // ��{�OSN-e�

base64

## [m] encode#

### encode(o, encoding?)#

- o { string | JsByteArray | ByteArray } - 待编码数据
- [ encoding = `'UTF_8'` ] { StandardCharset } - 字符编码
- returns { string }

对数据进行 Base64 编码.

    /* 字符串. */

    console.log(base64.encode('hello', 'iso-8859-1')); // aGVsbG8=
    console.log(base64.encode('hello', 'us-ascii')); // aGVsbG8=
    console.log(base64.encode('hello', 'utf-8')); // aGVsbG8=
    console.log(base64.encode('hello', 'utf-16')); // /v8AaABlAGwAbABv
    console.log(base64.encode('hello', 'utf-16be')); // AGgAZQBsAGwAbw==
    console.log(base64.encode('hello', 'utf-16le')); // aABlAGwAbABvAA==

    /* JavaScript 字节数组. */

    console.log(base64.encode([ 104, 101, 108, 108, 111 ], 'utf-8')); // aGVsbG8=

    /* Java 字节数组. */

    console.log(base64.encode(new java.lang.String('hello').getBytes(), 'utf-8')); // aGVsbG8=

    let jsArr = [ 104, 101, 108, 108, 111 ];
    let javaArr = util.java.array('byte', jsArr.length);
    jsArr.forEach((o, i) => javaArr[i] = o);
    console.log(base64.encode(javaArr, 'utf-8')); /* 效果同上. */

## [m] decode#

### decode(o, encoding?)#

- o { string | JsByteArray | ByteArray } - 待解码数据
- [ encoding = `'UTF_8'` ] { StandardCharset } - 字符编码
- returns { string }

对数据进行 Base64 解码.

    /* 字符串. */

    console.log(base64.decode('aGVsbG8=', 'iso-8859-1')); // hello
    console.log(base64.decode('aGVsbG8=', 'us-ascii')); // hello
    console.log(base64.decode('aGVsbG8=', 'utf-8')); // hello
    console.log(base64.decode('/v8AaABlAGwAbABv', 'utf-16')); // hello
    console.log(base64.decode('AGgAZQBsAGwAbw==', 'utf-16be')); // hello
    console.log(base64.decode('aABlAGwAbABvAA==', 'utf-16le')); // hello

    /* JavaScript 字节数组. */

    console.log(base64.decode([ 97, 71, 86, 115, 98, 71, 56, 61 ], 'utf-8')); // hello

    /* Java 字节数组. */

    console.log(base64.decode(new java.lang.String('aGVsbG8=').getBytes(), 'utf-8')); // hello

    let jsArr = [ 97, 71, 86, 115, 98, 71, 56, 61 ];
    let javaArr = util.java.array('byte', jsArr.length);
    jsArr.forEach((o, i) => javaArr[i] = o);
    console.log(base64.decode(javaArr, 'utf-8')); /* 效果同上. */