1 Star 3 Fork 0

DCloud/uni-portal

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
贡献代码
同步代码
取消
提示: 由于 Git 不支持空文件夾,创建文件夹后会生成空的 .keep 文件
Loading...
README
Apache-2.0

uni-portal 统一发布页

为什么需要 uni-portal 统一发布页?

App/小程序/网站做好后,如何告知你的用户?

你需要开发App的下载页、小程序二维码的展示页面,这些内容最好汇总在统一入口,也就是发行平台。

自己从头开发这么一个发行平台,需要考虑的事情太多了:

  • 响应式布局,兼容PC/Mobile各种尺寸
  • 微信/微博浏览器判断不同逻辑,右上角提示通过浏览器打开
  • PC上制作二维码,方便用户直接扫码下载
  • 如果小程序有多个版本,微信、支付宝、百度、QQ、快应用,那搞起来。。。

别急,有了uni-portal 统一发布页,一切迎刃而解,10分钟内搞定所有。

uni-portal 插件特征:

  • 基于 uni-app & uniCloud 实现
  • 遵循 uni-admin 框架规范,可直接导入 Admin 项目中
  • 支持 App、小程序、H5、快应用 灵活修改发布,实时线上更新
  • 支持生成发布页的静态页面,您可以将其上传到uniCloud前端网页托管中,自动启用CDN加速
  • 数据表设计,遵循 opendb 规范

如何获取本插件

准备工作:

  • uni-portal遵循 uni_modules规范,故需您的HBuilderX版本高于3.1.0+;若版本过低,请先升级HBuilderX;
  • uni-portal作为uni-admin的插件,需您本地先安装uni-admin项目,并已关联好服务空间;

做完如上准备工作后,请按照如下步骤进行安装:

  1. 在插件市场打开本插件页面,在右侧点击使用 HBuilderX 导入插件,选择 uni-admin 项目点击确定

  2. 等待下载安装完毕。注意:由于本插件依赖一些 uni-ui 插件,下载完成后会显示合并插件页面,自行选择即可

  3. 找到/uni_modules/uni-portal/uniCloud/cloudfunctions,右键上传所有云函数

  4. 找到/uni_modules/uni-portal/uniCloud/database/db_init.json,右键初始化数据库

  5. 编辑pages.json,增加如下内容

    //此结构与uni-admin中的pages.json结构一致
    "pages": [
          // ……其他页面配置
          {
            "path" : "uni_modules/uni-portal/pages/index",
            "style" :{
                "navigationBarTitleText": "发布应用",
                "enablePullDownRefresh": false
            }
          }
    ]
  6. 应用管理列表中,添加“发布”按钮,作为uni-portal统一发布页的入口。

    找到并编辑 uni-admin 项目下/pages/system/app/list.vue,在原编辑删除按钮之前,添加发布按钮,编辑后内容如下:

    <view v-else class="uni-group">
        <!-- 这里是新增的发布按钮,若有国际化需求,请到国际化配置文件中进行编辑 -->
        <button @click="navigateTo('/uni_modules/uni-portal/pages/index?id='+item.appid, false)" class="uni-button" size="mini" type="primary">发布</button>
        <!-- 下方是原有的编辑、删除按钮 -->
        <button @click="navigateTo('./edit?id='+item._id, false)" class="uni-button" size="mini" type="primary">{{$t('common.button.edit')}}</button>
        <button @click="confirmDelete(item._id)" class="uni-button" size="mini" type="warn">{{$t('common.button.delete')}}</button>
    </view>
  7. manifest.json -> 源码视图中添加以下配置:

    "networkTimeout":{
    	"uploadFile":1200000	// 单位:ms。 如果不配置,上传大文件可能会超时
    }
  8. 运行项目到Chrome

注意事项:

  1. 本插件依赖 uni-ui 中的部分组件,在运行项目到Chrome之前,建议先右键/uni_modules/uni-portal安装第三方依赖;
  2. 本插件使用了clientDB,故可能需要在uni-config-center插件中添加uni-id的配置。

如提示公用模块uni-id缺少配置信息,可按如下步骤解决:

  • a>. 点击uni-config-center导入插件
  • b>. 在/uniCloud/cloudfunctions/common/uni-config-center/下创建uni-id文件夹,文件夹内创建config.json文件。
  • c>. 点击config.json 默认配置。将内容拷贝至config.json中;拷贝完毕后,请务必删除注释

如何使用本插件

如果安装正确,管理员登录uni-admin管理后台,点击应用管理菜单,在应用列表项右侧看到发布按钮,如下图所示:

若未看到发布按钮,请返回如何获取本插件章节,仔细检查安装步骤。

应用发布信息填写

  • 基础信息

    1. AppID:所要发布的 app 的 id。唯一。
    2. 自动填充:如果你的uni-admin项目同时使用了升级中心,那么当你填写了AppID点击按钮后,会自动从升级中心同步 App 的一些信息。
  • 图片素材

    1. 应用图标:该应用的图标信息,在生成页面会用来生成当前页二维码
    2. 应用截图:该应用的实际截图信息
  • App 下载信息

    1. 勾选代表需要发布此类信息,不勾选会默认折叠
    2. 可以选择手动填写还是上传安装包到云存储自动填写下载链接
    3. 自动填充:如果你的uni-admin项目同时使用了升级中心,那么当你填写了AppID点击按钮后,会自动从升级中心同步 App 当前已上线的安装包信息。
  • 小程序信息

    1. 勾选代表需要发布此类信息,不勾选会默认折叠
    2. 折叠:小程序种类繁多,此按钮可以将所有的小程序信息折叠起来
  • H5、快应用

    1. H5:当你填写了链接,才会在生成页面显示
    2. 快应用:只有上传了快应用码,才会在生成页面展示
  • 填写完成点击 保存 即可,会有弹窗提示保存成功,是否立即下载统一发布页面

    点击 即可下载统一发布页面

统一发布静态页

上传部署

uni-portal 统一发布页面是静态HTML页面,可以直接在本地浏览器中打开查看。您可以部署在任何服务器中以供访问。

推荐使用 前端网页托管

  • 免费的 CDN加速:不经过web server,页面和资源直接上cdn,就近访问,速度更快。
  • 省心:无需再购买虚拟机、安装操作系统、配置web服务器、处理负载均衡、处理大并发、处理DDoS攻击......您什么都不用管,只需上传您写的页面文件。

注意:

  • 静态页面上传到 前端网页托管 使用默认域名访问时,会有一定的限制。但是这些限制在配置域名后都就不存在了。
  • 如果遇到静态页面打开图片或者二维码不显示的情况,请在 uniCloud Web 控制台 配置跨域设置。

页面展示效果

uni-portal 统一发布页面是响应式的,兼容PC宽屏和手机窄屏。

PC宽屏

手机窄屏

手机浏览器上,默认展示效果如下:

uni-portal统一发布页同时会识别当前浏览器环境,在微信等特殊浏览器上,自动提示“点击右上角菜单,在浏览器中打开”,效果如下:

Apache License Version 2.0, January 2004 http://www.apache.org/licenses/ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 1. Definitions. "License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document. "Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License. "Legal Entity" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, "control" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity. "You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this License. "Source" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files. "Object" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types. "Work" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below). "Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof. "Contribution" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as "Not a Contribution." "Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work. 2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form. 3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed. 4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions: (a) You must give any other recipients of the Work or Derivative Works a copy of this License; and (b) You must cause any modified files to carry prominent notices stating that You changed the files; and (c) You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and (d) If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License. You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License. 5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions. 6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file. 7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License. 8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages. 9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability. END OF TERMS AND CONDITIONS APPENDIX: How to apply the Apache License to your work. To apply the Apache License to your work, attach the following boilerplate notice, with the fields enclosed by brackets "[]" replaced with your own identifying information. (Don't include the brackets!) The text should be enclosed in the appropriate comment syntax for the file format. We also recommend that a file or class name and description of purpose be included on the same "printed page" as the copyright notice for easier identification within third-party archives. Copyright [yyyy] [name of copyright owner] Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

简介

uni-portal 统一发布页 展开 收起
HTML 等 3 种语言
Apache-2.0
取消

发行版

暂无发行版

贡献者

全部

近期动态

加载更多
不能加载更多了
马建仓 AI 助手
尝试更多
代码解读
代码找茬
代码优化
1
https://gitee.com/dcloud/uni-portal.git
git@gitee.com:dcloud/uni-portal.git
dcloud
uni-portal
uni-portal
master

搜索帮助

A270a887 8829481 3d7a4017 8829481