@quicktvui/ai 1.0.0

package/rules/.docs/zh-CN/sdk/light-card.md

@@ -0,0 +1,116 @@
+---
+title: 轻卡
+lang: zh-CN
+---
+
+放下载apk和项目源码
+
+# 轻卡
+
+快应用轻卡是专为原生应用与快应用混合开发的解决方案。轻卡由JSView实现，可以将其嵌入到任意大小、任意位置的安卓ViewGroup当中。在为原生应用添加动态化能力的同时，实现了与原生应用的一致体验。
+
+<video width="80%" src="/sdk/light-card.mp4" controls autoplay muted loop />
+
+如上所示，整个界面是安卓原生开发，`Js轻卡` 、 `JsFragment`以及`轻卡弹窗`里的界面是vue开发。
+
+<br>
+<br>
+
+## 混合开发
+<video width="80%" src="/sdk/combined.mp4" controls muted />
+
+
+## 示例代码
+
+### 1. 简单使用
+``` java
+public class MainActivity extends AppCompatActivity {
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_main);
+
+        // 第一步. 设置加载参数
+        EsData data = new EsData();
+        data.setAppPackage("轻卡应用的包名");
+
+        // 第二步. 加载轻卡应用
+        JsSlotViewManager.get().attachToActivity(this, data);
+
+        // 第三步. 创建轻卡
+        JsSlotView jsView = JsSlotViewManager.get().createJSView(this, "weather");
+
+        findViewById<ViewGroup>(R.id.jsview_container).addView(jsView);
+    }
+
+    @Override
+    protected void onDestroy() {
+        super.onDestroy();
+
+        // 卸载轻卡应用
+        JsSlotViewManager.get().detachFromActivity(this);
+    }
+}
+
+```
+
+### 2. 在RecyclerView中使用
+
+``` java
+RecyclerView rv = new RecyclerView(this);
+rv.setLayoutManager(new LinearLayoutManager(this));
+rv.setAdapter(new JsViewAdapter(this));
+setContentView(rv);
+
+private static final class JsViewAdapter extends RecyclerView.Adapter<JsViewAdapter.ViewHolder> {
+    private final String[] mViewIds = new String[] {"weather", "clock", "qlist"};
+    private final Context mContext;
+    public JsViewAdapter(Context context) {
+        this.mContext = context;
+    }
+    @Override
+    public int getItemCount() {
+        return mViewIds.length;
+    }
+    @NonNull
+    @Override
+    public ViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
+        return new ViewHolder(new FrameLayout(mContext));
+    }
+    @Override
+    public void onBindViewHolder(@NonNull ViewHolder holder, int position) {
+        if (holder.jsView == null) {
+            JsSlotView jsView = JsSlotViewManager.get().createJSView(mContext, mViewIds[position]);
+            ((ViewGroup)holder.itemView).addView(jsView);
+            holder.jsView = jsView;
+        }
+        holder.jsView.getRecyclerViewEventHandler()
+                .onBindViewHolder(position, "传递数据到Vue");
+    }
+    @Override
+    public void onViewAttachedToWindow(@NonNull ViewHolder holder) {
+        super.onViewAttachedToWindow(holder);
+        holder.jsView.getRecyclerViewEventHandler()
+                .onViewAttachedToWindow(holder.getAdapterPosition());
+    }
+    @Override
+    public void onViewDetachedFromWindow(@NonNull ViewHolder holder) {
+        super.onViewDetachedFromWindow(holder);
+        holder.jsView.getRecyclerViewEventHandler()
+                .onViewDetachedFromWindow(holder.getAdapterPosition());
+    }
+    @Override
+    public void onViewRecycled(@NonNull ViewHolder holder) {
+        super.onViewRecycled(holder);
+        holder.jsView.getRecyclerViewEventHandler()
+                .onViewRecycled(holder.getAdapterPosition());
+    }
+
+    private static final class ViewHolder extends RecyclerView.ViewHolder {
+        public JsSlotView jsView;
+        public ViewHolder(View itemView) {
+            super(itemView);
+        }
+    }
+}
+```

package/rules/.docs/zh-CN/sdk/overview.md

@@ -0,0 +1,5 @@
+# SDK
+这里介绍集成SDK后，能让原生应用具备哪些功能。
+集成SDK，让您的应用变身为快应用。
+
+[开源地址](#)

package/rules/.docs/zh-CN/tool/api/overview.md

@@ -0,0 +1,103 @@
+---
+title: API
+lang: zh-CN
+---
+
+# qt 全局变量 ^(alpha)
+
+全局变量`qt`中支持组件`API`快捷调用
+
+示例代码
+
+```ts
+const viewRef = ref<QtIView>()
+qt.view.requestFocus(viewRef)
+```
+
+### Component
+
+| Name                       |    Component               | Description                                                         |
+| ------------------------- | --------------------------- | ------------------------------------------------------------------- |
+| `qt.animation`            |   QtAnimation               | [点击查看详细API](/zh-CN/component/animation/introduction#exposes)                 |
+| `qt.appIcon`              |   QtAppIcon                 | [点击查看详细API](/zh-CN/component/app-icon#exposes)                  |
+| `qt.button`               |   QtButton                  | [点击查看详细API](/zh-CN/component/button#exposes)                    |
+| `qt.card`                 |   QtCard                    | [点击查看详细API](/zh-CN/component/card#exposes)                      |
+| `qt.cardContainer`        |   QtCardContainer           | [点击查看详细API](/zh-CN/component/card-container#exposes)            |
+| `qt.classifiedListView`   |   QtClassifiedListView      | [点击查看详细API](/zh-CN/component/classified-list-view#exposes)      |
+| `qt.collapse`             |   QtCollapse                | [点击查看详细API](/zh-CN/component/collapse#exposes)                  |
+| `qt.column`               |   QtColumn                  | [点击查看详细API](/zh-CN/component/column#exposes)                    |
+| `qt.flexView`             |   QtFlexView                | [点击查看详细API](/zh-CN/component/flex-view#exposes)                 |
+| `qt.gridView`             |   QtGridView                | [点击查看详细API](/zh-CN/component/grid-view#exposes)                 |
+| `qt.image`                |   QtImage                   | [点击查看详细API](/zh-CN/component/image#exposes)                     |
+| `qt.itemStore`            |   QtItemStore               | [点击查看详细API](/zh-CN/component/item-store#exposes)                |
+| `qt.itemView`             |   QtItemView                | [点击查看详细API](/zh-CN/component/item-view#exposes)                 |
+| `qt.largeList`            |   QtLargeList               | [点击查看详细API](/zh-CN/component/large-list#exposes)                |
+| `qt.listItem`             |   QtListItem                | [点击查看详细API](/zh-CN/component/list-item#exposes)                 |
+| `qt.listView`             |   QtListView                | [点击查看详细API](/zh-CN/component/list-view#exposes)                 |
+| `qt.loading`              |   QtLoadingView             | [点击查看详细API](/zh-CN/component/loading#exposes)                   |
+| `qt.lottieView`           |   QtLottie                  | [点击查看详细API](/zh-CN/component/lottie/introduction#exposes)                    |
+| `qt.navBar`               |   QtNavBar                  | [点击查看详细API](/zh-CN/component/nav-bar#exposes)                   |
+| `qt.playMarkView`         |   QtPlayMarkView            | [点击查看详细API](/zh-CN/component/play-mark-view#exposes)            |
+| `qt.pluginView`           |   QtPluginView              | [点击查看详细API](/zh-CN/component/plugin-view#exposes)               |
+| `qt.poster`               |   QtPoster                  | [点击查看详细API](/zh-CN/component/poster#exposes)                    |
+| `qt.progressBar`          |   QtProgressBar             | [点击查看详细API](/zh-CN/component/progress-bar#exposes)              |
+| `qt.qrCode`               |   QtQrCode                  | [点击查看详细API](/zh-CN/component/qr-code#exposes)                   |
+| `qt.replaceChildView`     |   QtReplaceChild            | [点击查看详细API](/zh-CN/component/replace-child#exposes)             |
+| `qt.rippleView`           |   QtRippleView              | [点击查看详细API](/zh-CN/component/ripple-view#exposes)               |
+| `qt.row`                  |   QtRow                     | [点击查看详细API](/zh-CN/component/row#exposes)                       |
+| `qt.scrollView`           |   QtScrollView              | [点击查看详细API](/zh-CN/component/scroll-view#exposes)               |
+| `qt.section`              |   QtVueSection              | [点击查看详细API](/zh-CN/component/vue-section#exposes)               |
+| `qt.seekBar`              |   QtSeekBar                 | [点击查看详细API](/zh-CN/component/seek-bar#exposes)                  |
+| `qt.mediaSeries`          |   QtMediaSeries             | [点击查看详细API](/zh-CN/component/media-series#exposes)              |
+| `qt.surfaceView`          |   QtSurfaceView             | [点击查看详细API](/zh-CN/component/surface-view#exposes)              |
+| `qt.swiftList`            |   QtSwiftList               | [点击查看详细API](/zh-CN/component/swift-list#exposes)                |
+| `qt.swiperSlide`          |   QtSwiperSlide             | [点击查看详细API](/zh-CN/component/swiper-slide#exposes)              |
+| `qt.tabs`                 |   QtTabs                    | [点击查看详细API](/zh-CN/component/tabs#exposes)                      |
+| `qt.tabsView`             |   QtTabsView                | [点击查看详细API](/zh-CN/component/tabs-view#exposes)                 |
+| `qt.text`                 |   QtText                    | [点击查看详细API](/zh-CN/component/text#exposes)                      |
+| `qt.transitionImg`        |   QtTransitionImg           | [点击查看详细API](/zh-CN/component/transition-img#exposes)            |
+| `qt.view`                 |   QtView                    | [点击查看详细API](/zh-CN/component/view#exposes)                      |
+| `qt.viewPager`            |   QtViewPager               | [点击查看详细API](/zh-CN/component/view-pager#exposes)                |
+| `qt.waterfall`            |   QtWaterfall               | [点击查看详细API](/zh-CN/component/waterfall#exposes)                 |
+| `qt.webView`              |   QtWebView                 | [点击查看详细API](/zh-CN/component/web-view#exposes)                  |
+| `qt.x5WebView`            |   QtX5webView               | [点击查看详细API](/zh-CN/component/x5web-view#exposes)                |
+
+### Module
+
+| Name                      |    Module                   | Description                                                         |
+| ------------------------- | --------------------------- | ------------------------------------------------------------------- |
+| `qt.log`                  |   ESLog                     | [点击查看详细API](/zh-CN/module/log#exposes)                 |
+| `qt.es`                   |   ES                        | [点击查看详细API](/zh-CN/module/es#exposes)                  |
+| `qt.develop`              |   ESDevelop                 | [点击查看详细API](/zh-CN/module/develop#exposes)                    |
+| `qt.toast`                |   ESToast                   | [点击查看详细API](/zh-CN/module/toast#exposes)                      |
+| `qt.storage`              |   ESLocalStorage            | [点击查看详细API](/zh-CN/module/local-storage#exposes)            |
+| `qt.device`               |   ESDevice                  | [点击查看详细API](/zh-CN/module/device#exposes)      |
+| `qt.display`              |   ESDisplay                 | [点击查看详细API](/zh-CN/module/display#exposes)                  |
+| `qt.network`              |   ESNetwork                 | [点击查看详细API](/zh-CN/module/network#exposes)                    |
+| `qt.appList`              |   ESAppList                 | [点击查看详细API](/zh-CN/module/app-list#exposes)                 |
+| `qt.power`                |   ESPower                   | [点击查看详细API](/zh-CN/module/power#exposes)                 |
+| `qt.permission`           |   ESPermission              | [点击查看详细API](/zh-CN/module/permission#exposes)                 |
+| `qt.usbDevice`            |   ESUsbDevice               | [点击查看详细API](/zh-CN/module/usb#exposes)                 |
+| `qt.broadcast`            |   ESBroadcast               | [点击查看详细API](/zh-CN/module/broadcast#exposes)                 |
+| `qt.audio`                |   ESAudio                   | [点击查看详细API](/zh-CN/module/audio#exposes)                 |
+| `qt.shareData`            |   ESShareData               | [点击查看详细API](/zh-CN/module/share-data#exposes)                 |
+| `qt.runtime`              |   ESRuntime                 | [点击查看详细API](/zh-CN/module/runtime#exposes)                 |
+| `qt.plugin`               |   ESPlugin                  | [点击查看详细API](/zh-CN/module/plugin#exposes)                 |
+| `qt.download`             |   ESDownload                | [点击查看详细API](/zh-CN/module/download#exposes)                 |
+| `qt.upload`               |   ESUpload                  | [点击查看详细API](/zh-CN/module/upload#exposes)                 |
+| `qt.actionBar`            |   ESActionBar               | [点击查看详细API](/zh-CN/module/action-bar#exposes)                 |
+| `qt.iac`                  |   ESIAC                     | [点击查看详细API](/zh-CN/module/iac#exposes)                 |
+| `qt.location`             |   ESLocation                | [点击查看详细API](/zh-CN/module/location#exposes)                 |
+| `qt.provider`             |   ESContentProvider         | [点击查看详细API](/zh-CN/module/content-provider#exposes)                 |
+| `qt.eventBus`             |   ESEventBus                | [点击查看详细API](/zh-CN/module/event-bus#exposes)                 |
+| `qt.xlog`                 |   ESXLog                    | [点击查看详细API](/zh-CN/module/xlog#exposes)                 |
+| `qt.brightness`           |   ESBrightness              | [点击查看详细API](/zh-CN/module/brightness#exposes)                 |
+| `qt.service`              |   ESService                 | [点击查看详细API](/zh-CN/module/service#exposes)                 |
+
+
+
+
+
+
+
+

package/rules/.docs/zh-CN/tool/cli/adb.md

@@ -0,0 +1,32 @@
+---
+title: 'ADB'
+lang: zh-CN
+---
+
+# Android 调试桥 (adb)
+
+[点击查看ADB使用指南](https://developer.android.google.cn/tools/adb?hl=zh-cn)
+
+## 连接设备
+
+ ``` shell
+qui adb connect 192.168.90.90
+ ```
+
+## 断开指定设备
+
+ ``` shell
+qui adb disconnect 192.168.90.90
+ ```
+
+## 断开所有设备
+
+ ``` shell
+qui adb disconnect
+ ```
+
+## 显示所有连接设备
+
+ ``` shell
+qui adb devices
+ ```

package/rules/.docs/zh-CN/tool/cli/build.md

@@ -0,0 +1,14 @@
+---
+title: 'Build'
+lang: zh-CN
+---
+
+# 编译并打包项目
+
+进入需要编译的项目根目录，执行命令。
+
+ ``` shell
+qui build
+ ```
+
+命令执行完毕，会在项目根目录下生成`dist`目录，并在`dist`目录中生成打包产物`*.rpk`。

package/rules/.docs/zh-CN/tool/cli/clean.md

@@ -0,0 +1,12 @@
+---
+title: 'Clean'
+lang: zh-CN
+---
+
+# 清理项目
+
+进入需要清理的项目根目录
+
+ ``` shell
+qui clean
+ ```

package/rules/.docs/zh-CN/tool/cli/config.md

@@ -0,0 +1,37 @@
+---
+title: 'Config'
+lang: zh-CN
+---
+
+# 配置
+
+## 显示所有配置
+
+```shell
+qui config --list
+```
+
+<img src="/tool/cli/cli_config_list.png" />
+
+## 配置仓库地址
+
+```shell
+qui config -r 仓库地址
+```
+
+::: warning 注意：默认使用官方仓库地址，无需配置。
+:::
+
+## 配置用户名
+
+```shell
+qui config -u 用户名
+```
+
+## 配置密码
+
+```shell
+qui config -p 密码
+```
+
+

package/rules/.docs/zh-CN/tool/cli/create.md

@@ -0,0 +1,28 @@
+---
+title: 'Create'
+lang: zh-CN
+---
+
+# 创建项目
+
+ ``` shell
+qui create
+ ```
+
+<img src="/tool/cli/cli-create.jpg" />
+
+
+::: tip 提示
+`qui create @quicktvui/sample` 命令中
+
+* `@组织名/项目名` 为固定格式。
+* `quicktvui` 为组织名，请填写对应组织名（[参考中心仓库](/zh-CN/guide/publish/hub)）。
+* `sample`    为项目名，请填写对应项目名称（[参考中心仓库](/zh-CN/guide/publish/hub)）。
+
+<img src="/tool/cli/cli-create-hub.png" />
+:::
+
+
+::: warning 注意：如不需要上传中央仓库，可填写任意组织名和项目名。
+:::
+

package/rules/.docs/zh-CN/tool/cli/debug.md

@@ -0,0 +1,30 @@
+---
+title: 'Debug'
+lang: zh-CN
+---
+
+# 配置调试模式
+
+## 一、配置调试焦点
+
+* 打开焦点调试
+
+ ``` shell
+qui debug -f true
+ ```
+
+<img src="/guide/focus/debug-focus.png" />
+
+* 关闭焦点调试
+
+ ``` shell
+qui debug -f false
+ ```
+
+## 二、配置调试服务地址
+
+ ``` shell
+qui debug -s 192.168.80.158
+ ```
+
+<img src="/tool/cli/cli_debug_server_host.png" />

package/rules/.docs/zh-CN/tool/cli/info.md

@@ -0,0 +1,14 @@
+---
+title: 'Info'
+lang: zh-CN
+---
+
+# 显示环境信息
+
+进入项目根目录
+
+ ``` shell
+qui info
+ ```
+
+<img src="/tool/cli/cli-info.jpg" />

package/rules/.docs/zh-CN/tool/cli/installation.md

@@ -0,0 +1,12 @@
+---
+title: 'Install'
+lang: zh-CN
+---
+
+# 安装
+
+![](https://img.shields.io/npm/v/@quicktvui/cli)
+
+ ``` shell
+npm install -g @quicktvui/cli@latest
+ ```

package/rules/.docs/zh-CN/tool/cli/introduction.md

@@ -0,0 +1,26 @@
+---
+title: 'Introduction'
+lang: zh-CN
+---
+
+# 简介
+
+`qui` cli支持以下命令
+
+* 环境信息 [`qui info`](/zh-CN/tool/cli/info)
+* 配置开发环境 [`qui setup`](/zh-CN/tool/cli/setup)
+* 配置 [`qui config`](/zh-CN/tool/cli/config)
+* 创建项目 [`qui create`](/zh-CN/tool/cli/create)
+* 调试 [`qui debug`](/zh-CN/tool/cli/debug)
+* 清理 [`qui clean`](/zh-CN/tool/cli/clean)
+* 编译并打包项目 [`qui build`](/zh-CN/tool/cli/build)
+* 打包项目 [`qui pack`](/zh-CN/tool/cli/pack)
+* 发布项目到仓库 [`qui publish`](/zh-CN/tool/cli/publish)
+* 发布预览 [`qui preview`](/zh-CN/tool/cli/preview)
+* 启动应用 [`qui start`](/zh-CN/tool/cli/start)
+* 迁移 [`qui migrate`](/zh-CN/tool/cli/migrate)
+* Android 调试桥 (adb) [`qui adb`](/zh-CN/tool/cli/adb)
+* 日志 [`qui logcat`](/zh-CN/tool/cli/logcat)
+* 测试 [`qui test`](/zh-CN/tool/cli/test)
+
+<img src="/tool/cli/cli.png" />

package/rules/.docs/zh-CN/tool/cli/logcat.md

@@ -0,0 +1,10 @@
+---
+title: 'Logcat'
+lang: zh-CN
+---
+
+# 打印日志
+
+ ``` shell
+qui logcat
+ ```

package/rules/.docs/zh-CN/tool/cli/migrate.md

@@ -0,0 +1,12 @@
+---
+title: 'Migrate'
+lang: zh-CN
+---
+
+# 迁移
+
+旧项目升级到新项目
+
+ ``` shell
+qui migrate
+ ```

package/rules/.docs/zh-CN/tool/cli/pack.md

@@ -0,0 +1,14 @@
+---
+title: 'Pack'
+lang: zh-CN
+---
+
+# 打包项目为`rpk`
+
+进入需要编译的项目根目录，执行命令。
+
+ ``` shell
+qui pack
+ ```
+
+命令执行完毕，会在项目根目录下生成`dist`目录，并在`dist`目录中生成打包产物`*.rpk`。

package/rules/.docs/zh-CN/tool/cli/preview.md

@@ -0,0 +1,18 @@
+---
+title: 'Preview'
+lang: zh-CN
+---
+
+# 预览
+
+## 在项目中预览本应用
+
+ ``` shell
+qui preview
+ ```
+
+## 预览应用
+
+ ``` shell
+qui preview -p @org/pkg -v 0.0.2
+ ```

package/rules/.docs/zh-CN/tool/cli/publish.md

@@ -0,0 +1,12 @@
+---
+title: 'Publish'
+lang: zh-CN
+---
+
+# 发布项目
+
+进入需要编译的项目根目录。
+
+ ``` shell
+qui publish
+ ```

package/rules/.docs/zh-CN/tool/cli/setup.md

@@ -0,0 +1,58 @@
+---
+title: 'Setup'
+lang: zh-CN
+---
+
+# 配置开发环境
+
+在命令行输入：
+
+ ``` shell
+qui setup
+ ```
+
+## 第一步、连接安卓设备
+
+输入安卓设备地址
+
+<img src="/tool/cli/cli_setup_connect_device.jpg" />
+
+::: warning 常见错误：
+
+* 设备 USB 调试没有打开，会报如下错误：
+
+<img src="/tool/cli/cli_setup_disconnected.jpg" />
+
+* IP 地址输入错误或者网络不可用，会报如下错误：
+
+<img src="/tool/cli/cli_setup_connect_error.jpg" />
+
+:::
+
+## 第二步、安装调试容器
+
+1、 选择调试容器版本
+
+<img src="/tool/cli/cli_setup_select_runtime.jpg" />
+
+2、 下载调试容器（自动执行）
+
+<img src="/tool/cli/cli_setup_download_apk.jpg" />
+
+3、 安装调试容器（自动执行）
+
+<img src="/tool/cli/cli_setup_install_apk.jpg" />
+
+## 第三步、启动容器，并设置服务调试地址（自动执行）
+
+<img src="/tool/cli/cli_setup_completed.jpg" />
+
+::: tip 手动配置调试服务地址
+
+[点击查看 qui debug 命令](/zh-CN/tool/cli/debug#二、配置调试服务地址)
+
+:::
+
+## 第四步、设置完成
+
+提示：`Setup Completed!`，设置成功！

package/rules/.docs/zh-CN/tool/cli/start.md

@@ -0,0 +1,54 @@
+---
+title: 'Start'
+lang: zh-CN
+---
+
+# 打开应用
+
+## 一、打开线上快应用
+
+ ``` shell
+# 基本用法：qui start 快应用包名@版本名称
+qui start package@version
+ ```
+
+### 打开最新线上版本
+
+ ``` shell
+qui start com.quark.yun.tv
+ ```
+
+### 打开指定版本
+
+ ``` shell
+qui start com.quark.yun.tv@1.7.5.3
+ ```
+
+### 打开远程接口地址的快应用
+
+ ``` shell
+qui start com.quark.yun.tv -uri 192.168.40.45:38989
+ ```
+
+ ``` shell
+qui start com.quark.yun.tv -uri http://192.168.40.62/android.zip
+ ```
+
+### 打开本地服务的快应用
+
+ ``` shell
+qui start com.quark.yun.tv -l
+qui start com.quark.yun.tv -local
+ ```
+
+### 用指定的运行环境运行快应用（默认com.extscreen.runtime）
+
+ ``` shell
+qui start com.quark.yun.tv -p com.extscreen.runtime
+ ```
+
+## 二、打开仓库快应用
+
+ ``` shell
+qui start @organization/package/version
+ ```

package/rules/.docs/zh-CN/tool/cli/test.md

@@ -0,0 +1,22 @@
+---
+title: 'Test'
+lang: zh-CN
+---
+
+# 测试
+
+## 设置测试环境
+
+ ``` shell
+qui test setup
+ ```
+
+<img src="/tool/cli/cli_test_setup.jpg">
+
+## 启动测试环境
+
+ ``` shell
+qui test
+ ```
+
+<img src="/tool/cli/cli_test.jpg">

package/rules/.docs/zh-CN/tool/cli/upgrade.md

@@ -0,0 +1,12 @@
+---
+title: 'Upgrade'
+lang: zh-CN
+---
+
+# 升级
+
+进入需要升级的项目根目录
+
+ ``` shell
+qui upgrade
+ ```