# Js端开发入门文档指引

按照如下的顺序了解jsview文档,可以帮助快速入门JsView的JS端开发

  1. 确认node和npm版本;helloWorld创建,获得基础项目脚手架
    点击进入 node版本确认
    点击进入 运行HelloWorld工程

  2. 可用的css样式表(HTML元素,目前只支持 div 和 img,其他功能例如文字输入都有相应的组件完成)
    点击进入 目前支持的CSS样式表

  3. 了解关键组件:界面焦点控制JsvFocusBlock
    点击进入 JsvFocusBlock指南

  4. 了解关键组件:布局兼上下左右键接管的MetroWidget
    点击进入 MetroWidget指南

  5. 可以使用最常见的多TAB页面形态sample进行主界面工程搭建:
    样例1:
    仅有多tab主页样例:
    借鉴时,请clone后,切换到 master-offline 分支,然后npm ci后即可进行 npm run start来调试
    git clone http://gitlab.cluster.qcast.cn/mirror/jsview-vue3-tabUI-sample.git
    样例2:
    含有主页,详情页,全屏播放页:
    git clone http://gitlab.cluster.qcast.cn/mirror/epg-demo.git

  6. 如果不依赖java端功能接口的话,可以直接使用小程序之家apk来启动
    点击进入 在android上运行脚手架中的小程序

  7. 示例代码以及其源代码
    按照如下步骤,进行npm samples包安装和,修改src/main.tsx, 启用示例代码

  • 运行 npm install @shijiu/jsview-vue-samples && npm ci

  • 将main.tsx import App from './App.vue' 改为 import App, { router } from '@shijiu/jsview-vue-samples'

  • main.tsx 中添加 app.use(router)

// 修改 src/main.tsx

import { createApp } from 'vue'
import { jsvCreateFocusManager } from 'jsview'

// 修改点1: 将APP的引入改为从sample引入,并同时引入router
import App, { router } from '@shijiu/jsview-vue-samples'

const app = createApp(App)

// 修改点2: 追加router的初始化
app.use(router)

app.use(jsvCreateFocusManager(), '#app')

app.mount('#app')

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
  • 如果你想使用某个sample作为base,可以直接从@shijiu/jsview-vue-samples/xxx拷贝到src目录。
  • 具体模块对应可以对照 node_modules/@shijiu/jsview-vue-samples/DemoHomepage/router.js
  • Debug时如果需要临时去除启动图,可以用: ;(window as any).jJsvRuntimeBridge?.notifyPageLoaded()

示例代码运行效果URL:
http://cdn.release.qcast.cn/JsViewFrameworkTester/release_build_vue/1667/vue-vite/index.html

源代码位置:
MetroWidget样例Router检索:
node_modules/@shijiu/jsview-vue-samples/MetroWidgetDemos/routeList.js中记载的相对路径中 其余样例Router检索:
node_modules/@shijiu/jsview-vue-samples/DemoHomepage/router.js中记载的相对路径中

  1. 组件的使用说明
    每个组件的说明在其vue文件头中,组件的vue文件可以去目录 node_modules/@shijiu/jsview-vue/utils/ 中查找。
  • JsvFocusBlock: node_modules/@shijiu/jsview-vue/utils/JsViewEngineWidget/JsvFocus/JsvFocusBlock.vue

  • FocusHub: node_modules/@shijiu/jsview-vue/utils/JsViewEngineWidget/JsvFocus/JsvFocusHub.ts

  • MetroWidget: node_modules/@shijiu/jsview-vue/utils/JsViewEngineWidget/MetroWidget/MetroWidget.vue

  • 其余组件:node_modules/@shijiu/jsview-vue/utils/JsViewVueWidget 对应组件名的文件中查看。

    点击进入 组件列表说明

  1. 掌握android端的devtools调试方法
    点击进入 android端devtools接入方法

  2. 常见问题回答,例如"加载失败"弹出框的自查方法
    点击进入 常见问题回答列表

  3. 性能调优
    点击进入 利用vue.js timeline进行性能调优

Last Updated: 6/21/2024, 7:03:52 AM