【常见问题】SpreadJS授权激活汇总 & 常见问题

  如何激活授权？
SpreadJS的授权分为开发授权和部署授权，开发授权中又包含桌面表格编辑器的授权和本地开发授权两种授权。

一.激活桌面表格编辑器
开发授权中有一个以designer为开头的授权，该授权可用于激活桌面版表格编辑器。激活方法如下：
1. 下载产品的安装包 并在安装包的 Designer\Designer Runtime 目录下选择合适的应用程序进行安装。
2. 安装完毕后，打开桌面版表格编辑器并点击上方激活按钮（锁型图标），点击后弹出对话框。

3. 复制开发授权中以”Designer”开头的授权  Key，粘贴到下框中，点击确定按钮。

4.点击之后桌面版表格编辑器会自动验证授权并重启。

二.激活本地开发授权及部署授权
1）纯JS项目激活
   1. 引用  Spread.Sheets  的  JS  文件。

1.    <script src="[Your_Scripts_Path]/gc.spread.sheets.xxxx.xxxx.min.js" type="text/javascript"></script>

复制代码

   2. 添加授权。
       如果是激活本地开发授权，请将开发授权中除designer开头外的另一个授权完全复制替换下面代码的"Your Key"部分。
       如果是激活部署授权，在您专属商务的授权邮件中，复制以贵公司申请的域名或者  IP  名开头的部署授权  Key，替换下面代码的"Your Key"部分。
       您可以直接在声明  spread.Sheets  前加入此代码。

1.    GC.Spread.Sheets.LicenseKey = “Your Key”

复制代码

      或者，也可将此代码放入  license.js  文件中引用，方便项目管理。

1. <script src="[Your_Scripts_Path]/licensen.js" type="text/javascript"></script>

复制代码

   3. 使用  SpreadJS  表格。代码参考如下：

1. <script type="text/javascript">
   
2. //  添加授权
   
3. GC.Spread.Sheets.LicenseKey = “your key”;
   
4. // Your Code
   
5. window.onload = function(){
   
6.   var spread = new GC.Spread.Sheets.Workbook(document.getElementById("ss"),{sheetCount:3});
   
7.   var sheet = spread.getActiveSheet();
   
8. }
   
9. </script>

复制代码

上述方法用于在纯js的页面或项目下激活SpreadJS的本地开发授权或部署授权。需注意用于授权申请的GC.Spread.Sheets.LicenseKey = "your key";声明需在表格初始化之前完成。
2）VUE,React,Angular 框架中激活
在上述三个框架之后激活的原理是相同的，都是在 import 完毕之后声明部署授权进行激活，以react为例：

1. import React from 'react';
   
2. import './App.css';
   
3. import GC from '@grapecity/spread-sheets';
   
4. import { SpreadSheets, Worksheet } from '@grapecity/spread-sheets-react';
   
5. 
   
6. GC.Spread.Sheets.LicenseKey = "your key";

复制代码

从上述代码中我们可以看到，import @grapecity/spread-sheets 生成一个名为GC的对象。之后在GC这个对象下声明GC.Spread.Sheets.LicenseKey这个变量，将license赋值给这个变量，就完成了授权的操作。 VUE 和 Angular 同理。


这里有一点需要注意：
在上述框架之后，ExcelIO（Excel导入导出功能）需要额外单独进行授权，授权的license与SpreadJS相同，以下面代码为例：

1. import React from 'react';
   
2. import './App.css';
   
3. import GC from '@grapecity/spread-sheets';
   
4. import { SpreadSheets, Worksheet } from '@grapecity/spread-sheets-react';
   
5. 
   
6. // 导入ExcelIO模块
   
7. import * as spreadExcel from '@grapecity/spread-excelio';
   
8. 
   
9. // 导入文件保存模块
   
10. import saveAs from 'file-saver';
    
11. 
    
12. GC.Spread.Sheets.LicenseKey = spreadExcel.LicenseKey = "your key";

复制代码

当做了import * as spreadExcel from '@grapecity/spread-excelio'; 导入ExcelIO模块之后，需要在ExcelIO模块的对象spreadExcel上声明spreadExcel.LicenseKey这个变量，将license赋值给这个变量，就完成了对ExcelIO的授权操作。 VUE 和 Angular 同理。

三.激活在线表格编辑器
1）纯JS项目激活
   1. 引入在线表格编辑器相关的js文件，保证在线表格编辑器能够在本地正常跑起来。具体可以参考在线表格编辑器安装包中的sample示例

   2. 添加授权。
   在Designer初始化之前也就是new GC.Spread.Sheets.Designer.Designer之前加入下面的代码：

1. GC.Spread.Sheets.Designer.LicenseKey = "your designer license key"
   
2. GC.Spread.Sheets.LicenseKey = "your SpreadJS license key"

复制代码

  3.使用在线表格编辑器
   在添加授权之后，初始化在线表格编辑器

1. var designer = new GC.Spread.Sheets.Designer.Designer(document.getElementById("gc-designer-container"), config);

复制代码

2）VUE,React,Angular 框架中激活
在上述三个框架之后激活的原理是相同的，都是在 import 完毕之后声明对应的部署授权进行激活，这点跟SpreadJS的部署授权激活很像。以下面代码为例，下面代码是一个VUE的项目：

1. import '@grapecity/spread-sheets/styles/gc.spread.sheets.excel2013white.css'
   
2.   import '@grapecity/spread-sheets-designer/styles/gc.spread.sheets.designer.min.css'
   
3.   import '@grapecity/spread-sheets-designer-resources-cn';
   
4.   import GC from '@grapecity/spread-sheets';
   
5.   GC.Spread.Common.CultureManager.culture("zh-cn");
   
6.   import '@grapecity/spread-sheets-resources-zh';
   
7. 
   
8.   import { Designer } from '@grapecity/spread-sheets-designer-vue';
   
9.   
   
10.   
    
11.   import { designerconfig } from './config_2.js';
    
12.   import FileSaver from "file-saver";
    
13.   GC.Spread.Sheets.Designer.LicenseKey = "your deisgner license key";
    
14.   GC.Spread.Sheets.LicenseKey = "your SpreadJS license key";

复制代码

同时这里也要注意，如果引用ExcelIO，ExcelIO的模块也需要license激活，该licesne与SpreadJS的license相同。

  授权常见问题  

【常见问题】SpreadJS授权激活常见问题