itaro

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

(★ 12)

Taro 按需编译解决方案。

itaro Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<div align="center">
<h1>ITARO</h1>
<img src="./demo.gif"/>
<p>itaro 按需编译解决方案，从此告别改 1 行代码，编译半分钟的情况。</p>
</div>

## 安装

项目安装：

```bash
yarn add @dream2023/itaro -D # npm install --save-dev @dream2023/itaro
```

全局安装：

```bash
yarn global add @dream2023/itaro # npm install -g @dream2023/itaro
```

## 使用

### taro 1.x 和 2.x 使用方式

**第 1 步**：修改 `package.json`，增加 `scripts`，例如：

```json
{
  "dev:weapp": "npm run build:weapp -- --watch",
  "dev:itaro": "itaro npm run dev:weapp"
}
```

上面演示的是启动 `dev:weapp`，如果是启动 `build:h5`，可以增加 `itaro npm run build:h5`，其实就是在 `itaro` 后面跟着启动命令。

**第 2 步**：修改 `config/index.js` 的 `defineConstants` 字段为：

```js
{
  defineConstants: {
    'process.env.ITARO': process.env.ITARO
  }
}
```

**第 3 步**：修改 `app.jsx` 或者 `app.tsx`：

```jsx
// ...
class App extends Component {
  // 增加一个三元表达式
  config = process.env.ITARO
    ? process.env.ITARO
    : {
        pages: ["pages/index/index"],
        // ...
      }
}
```

### taro 3.x 使用方式

**第 1 步**：修改 `package.json`，增加 `scripts`，例如：

> 同 1.x 和 2.x。

```json
{
  "dev:weapp": "npm run build:weapp -- --watch",
  "dev:itaro": "itaro npm run dev:weapp"
}
```

上面演示的是启动 `dev:weapp`，如果是启动 `build:h5`，可以增加 `itaro npm run build:h5`，其实就是在 `itaro` 后面跟着启动命令。

**第 2 步**：修改 `app.config.js` 或者 `app.config.ts` 为：

```js
import itaro from "@dream2023/itaro"

export default itaro({
  pages: ["pages/index/index"],
  // ...
})
```

## 自定义编译模式

如果你使用了本工具，强烈建议配合小程序开发工具的 [自定义编译模式](https://blog.csdn.net/hongxue8888/article/details/104614445)，一步到自定义页面。

![itaro](https://raw.githubusercontent.com/dream2023/itaro/main/demo2.png)

## 特别说明

- `subpackages` 页面，如果选择了 `root` 页面，则会自动选择全部子页面；
- `tabBar` 中的页面会被自动选中，不会出现在选择列中；
- `preloadRule` 字段会被删除；
- `itaro` 会缓存用户的选择，所以当第二次启动时，会提示是否沿用之前的选择；
- 缓存是持久化文件存储的，所以一旦改变 `app` 的配置项（比如修改了 tabbar 或者新增了页面），再次启动时，需要重新选择来更新缓存！！！

itaro

itaro Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

itaro

itaro Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README