KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #typescript #ai-agent #developer-tools #claude-code #codex #deepseek-harness #ai-agents #react #mcp #rust

Pandora

★ 248 Open GitHub ↗

潘多拉的魔盒了解一下。

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Pandora

> Updating

### Introduction

> 在古希腊的神话中 Pandora 是世界上第一个女人，一个 all-gifted 的女人（具有一切天赋的女人），而潘多拉的魔盒里装着希望。

借着 `all-gifted` 的寓意，我创建了这个开源库: `Pandora`，她是一个精心挑选的工具类集合。

Pandora 与其他工具类库的不同：

0. 虽然说 Pandora 也可以算是工具类的集合，但是这里的类&方法的数量非常少，只选了极少数真的非常有用且有大概率复用的类，在保证避免编写大量样板代码的基础之上，减少引入不必要类的可能，防止包体积增大；
1. Pandora 包含两个版本，`basic` 以及 `full` ，可以满足不同人的不同需求；
2. 真正实用且好用，高质量的代码。

### Pandora 工程介绍

目前 Pandora 由两个模块组成 ：

1. `pandora-basic` ，只包含非常非常基础的工具类 ，绝大多数 App 都需要的工具类，在保证避免编写大量样板代码的基础之上，减少引入不必要类的可能，防止包体积增大；
2. `pandora-full` ，依赖并包含 basic ，会包含各种 Utils ，可能涉及到 Android 开发的方方面面。

当你只需要非常基础的能力时，可以依赖 `basic` 版本，如果需要更多，则选择 `full` 版本，更推荐只依赖 basic 版本。

### Getting Started

只依赖 baisc 能力:

```groovy
implementation 'me.yifeiyuan.pandora:pandora-basic:1.0.3'
```

依赖 full 能力：

```groovy
implementation 'me.yifeiyuan.pandora:pandora-full:1.0.3'
```

注意：full 版本包含 basic 版本的能力，所以不再需要添加 basic 的依赖。

### Basic 版本的能力介绍

注意: 方法可能有变，请以实际代码为准。

#### ApplicationUtils

一个可以设置、获取全局 Application 的工具类，Context 在 Android 中非常常用，但是其实很多时候我们不需要传递 Activity 类型的 Context ， **使用 `ApplicationUtils` 可以缓解我们到处传递 Context 的困境**。（默认会从 ActivityThread 获取 Application）

![applicationutils](https://raw.githubusercontent.com/czn6/Pandora/master/assets/applicationutils.png)

#### MainThread

一个关于主线程的工具类，**可以方便地将 Runnable post 到主线程执行**。

![mainthread](https://raw.githubusercontent.com/czn6/Pandora/master/assets/mainthread.png)

#### ToastUtils

一个全局单例 Toast ，**解决多次实例化 Toast 导致不停弹 Toast 的问题**。

![toastutils](https://raw.githubusercontent.com/czn6/Pandora/master/assets/toastutils.png)

#### LifecycleHandler

在使用 Handler 的时候我们总是担心 Handler 会导致内存泄露，于是我们每次都会在 onDestroy 方法里移除 Handler 的消息，编写样板代码，LifecycleHandler 的出现就是为了解决这个困境，**使用它，你不再需要关注 onDestroy 啦！**

![lifecyclehandler](https://raw.githubusercontent.com/czn6/Pandora/master/assets/lifecyclehandler.png)

#### UiUtils

Android 开发不可避免的要跟像素 dp 等打交道，UiUtils 包含一些数据单位转换的操作。

![uiutils](https://raw.githubusercontent.com/czn6/Pandora/master/assets/uiutils.png)

#### Predictions

一个用来做”断言”的功能的工具类，用来验证判断参数是否合法。

虽然我们有 NonNull 等注解 ，但是依然避免不了外部传递非法参数，这个时候我们避免不了写样板代码，检测参数是否非法，如果是则抛出异常，**Predictions 可以让你少写一些检查抛、异常的样板代码**。

![predictions](https://raw.githubusercontent.com/czn6/Pandora/master/assets/predictions.png)

### 贡献

欢迎提供更多更好用的 Utils ，请添加到 pandora-full 模块，并提 PR，感谢支持！

如果有 Bug ，非常欢迎提 issue 反馈！

可以 star 支持一下哟！~

Pandora

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README