• SharePoint Framework 把你的客户端web部件部署到经典的SharePoint页面


    博客地址:http://blog.csdn.net/FoxDave

    本节介绍如何把客户端web部件部署到SharePoint服务端页面。我们将继续使用之前的工程。

    将HelloWorld的web部件打包

    在命令行窗口中,跳转到web部件工程目录。跟在工作台不同,为了在SharePoint传统的服务端页面使用客户端web部件,你需要将web部件同SharePoint注册,首先要做的就是打包。

    在命令行中输入命令“code .”,用Visual Studio Code打开web部件工程,打开config文件夹中的package-solution.json文件,该文件定义了包的元数据,如下所示:

    {
      "solution": {
        "name": "myfirstwebpart-client-side-solution",
        "id": "a479dbd3-b750-424a-82aa-7b45dad74125",
        "version": "1.0.0.0"
      },
      "paths": {
        "zippedPackage": "solution/myfirstwebpart.spapp"
      }
    }

    在命令行窗口,输入下面的命令来打包包含web部件的客户端解决方案:

    gulp package-solution

    这个命令会在工程的sharepoint文件夹中创建一个spapp文件,在我的示例中名称为:myfirstwebpart.spapp。

    打包的内容

    打包功能会使用SharePoint功能(Feature)来打包你的web部件。默认情况下,gulp任务创建:

    >1个关于你的web部件的功能。

    >1个.webpart文件,即用来描述你的web部件的XML文件。

    你能在sharepoint文件夹中看到原始包的内容。

    这些内容会被打包到.spapp文件中,这个过程跟打包.wsp文件类似。这个包跟SharePoint add-ins包非常类似,使用Microsoft Open Packaging Conventions来打包你的解决方案。

    JavaScript文件、CSS和其他资产文件不会被打包,所以你需要将他们部署到一个外部的路径(比如CDN)。如果只是出于开发过程中测试的目的的话,你可以从本地电脑加载这些资产文件。

    将HelloWorld的包部署到应用程序目录

    接下来你需要将包部署到应用程序目录。访问你的网站应用程序目录。上传或是拖拽myfirstwebpart.spapp文件到应用程序目录。

    上传完毕之后会弹出部署确认对话框,点击Deploy即可。

    注意:你一定要在之前申请的开发者订阅中部署,现在还不支持普通的订阅。

    在你的站点中安装客户端解决方案

    访问你之前创建的开发者网站集。点击右上角的齿轮图标选择Add an app操作来添加我们之前部署的解决方案。具体过程就不详细说了,怎么向SharePoint站点中添加内容大家都知道。

    在传统SharePoint页面中预览web部件

    现在你已经成功部署并安装了客户端解决方案到你的站点,将这个web部件添加到一个传统的SharePoint页面。记住一些资源文件只在本地电脑可用。

    在dist文件夹中打开<your-webpart-guid>.manifest.json文件。可以看到loaderConfig中的internalModuleBaseUrls属性,在我的示例是如下:

    "loaderConfig": {
        "entryModuleId": "hello-world.bundle",
        "internalModuleBaseUrls": [
          "https://CNSY20160AAAL:4321/"

    在向SharePoint服务端页面添加web部件之前,运行本地服务器。在命令行中输入gulp serve --nobrowser命令,该命令不会自动运行SharePoint工作台。

    将HelloWorld的web部件添加到传统页面。

    访问你的网站集,创建一个页面。点击右上角的齿轮图标,选择网站内容。点击网站页面库进入,创建一个web部件页。

    创建完成后访问这个页面,将自动进入页面的编辑模式,点击添加Web部件操作,选择Custom中的我们部署的web部件。

    Web部件的资产会从本地环境加载。为了能够正确加载,你需要设置浏览器为允许加载不安全的脚本。

    启用之后就可以看到跟之前本地调试一样效果的web部件了,体验是一样的。

    资产文件在本地是个问题,假设我们做的是一款产品,从本地加载是不现实的。下一讲将介绍如何把web部件相关的资产文件放到CDN上。

    
  • 相关阅读:
    字典树(Trie)的学习笔记
    kmp学习笔记
    NOIP PJ游记
    Hash学习笔记
    神奇的差分法(内附树状数组的一点扩展)
    DLX算法一览
    A*与IDA*的奇妙之旅
    HDU_2553——n皇后问题,作弊
    HDU_2035——求A^B的最后三位数
    HDU_2034——集合A-B
  • 原文地址:https://www.cnblogs.com/justinliu/p/7703771.html
Copyright © 2020-2023  润新知