---
order: 5
navTitle: 扩展管理
indexTitle: 扩展管理
---
# 扩展管理

当需要使用系统默认不具备的功能时，我们需要通过扩展来实现。本文主要讲解如何进行扩展管理，包括下列内容：

\[\[toc]]

## 导入扩展{#import-extension}

### 扩展素材准备{#prepare-extension}

- 扩展文件：资源类型不同，需要的扩展文件要求不一样，可以通过[扩展点](../../dev/extension/extension-points/README.md)文档查看要求和方法
- 缩略图：用于扩展界面显示。建议使用png格式，尺寸为188x137，大小为5kb左右，名称为thumbnail.png

准备好上述素材后，制作成一个zip格式的压缩包。扩展压缩包的名称命名方式为`公司名-扩展点-自定义名称`，例如：`succ-font-numbers`。

### 在系统中加入扩展{#add-extension}

准备好扩展压缩包后，系统提供了两种加入扩展的入口：

1. 在任意项目下的**扩展**模块，点击**导入扩展**按钮，导入压缩包

![导入扩展](./images/2020-03-29-15-06-09.png)

2. 将压缩包导入到**系统数据**>**资源**>**extensions目录**

![扩展目录](./images/2020-03-23-12-27-46.png)

:::tip
这两种导入方法的效果是一致的，导入的扩展都能作用于所有项目。例如在A项目导入一个扩展插件，在B项目中同样能够使用这个扩展。
:::

## 编辑扩展{#edit-extension}

编辑扩展文件的方式有以下三种：

1. 在任意项目下的**扩展**模块找到需要修改的扩展，点击右下方的**三个点**按钮，选择**编辑扩展内容**即可进行编辑

![编辑扩展1](./images/2020-03-23-12-27-49.png)

2. 在**系统数据**>**资源**>**extensions目录**下找到需要修改的扩展文件，选中该扩展文件后在右侧的编辑器中进行修改。修改完成后点击上方的**保存**按钮

![编辑扩展2](./images/2020-03-29-15-13-40.png)

3. 在本地对扩展文件进行修改后重新导入到系统中，参考本文[导入扩展](#导入扩展)部分

:::tip
方法1和方法2适用于编辑js、action、ts、json等格式的扩展文件。如果需要修改图片、字体文件等无法在编译器修改的文件，建议使用方法3。
:::

## 删除扩展{#delete-extension}

目前系统中提供两种删除扩展的方法：

1. 在任意项目下的**扩展**模块中找到需要删除的扩展，点击右下方的**三个点**按钮，选择**删除**，在弹出的确认删除框中选择确定。
2. 在**系统数据**>**资源**>**extensions目录**下找到需要删除的扩展文件，右键点击后在菜单中选择删除，在弹出的确认删除框中选择确定

:::tip
删除后的扩展可以在系统回收站中找回。
:::

## 应用场景{#application-scenarios}

### 扩展新字体{#new-font}

1. 准备字体包
   - 导出系统扩展模块下的字体扩展包，解压到本地，文件夹命名规范为：succ-font-字体名称（英文格式）
     ![导出](./images/2022-09-08-14-47-00.png)
   - 替换掉原先的字体文件以及缩略图，字体文件可以在[网络](http://www.fonts.net.cn/)上进行下载
   - 编辑[package.json](../../dev/extension/extension-points/font.md#package.json)文件，json文件中**字体名称**以及**缩略图名称**与替换的文件保持一致

2. 上传字体包
   - 上传前需在**系统数据**>**资源**>**extensions目录**下新建文件夹，文件夹命名与字体包一致
     ![创建文件夹](./images/2022-09-08-14-49-00.png)
   - 上传后可在**扩展模块**下查看是否有新增字体
     :::tip 提示
     字体扩展包建议压缩后上传，若无法上传，需要在**系统设置**>**安全设置**>**阈值设置**>**文件上传**中添加相应文件类型，详情可查看文档[安全设置](../../sys-settings/security/securityconf.md#upload-file-restrictions)
     :::

3. 使用字体包
   - 在系统编辑页面设置字体为新增字体，确认是否可以正常使用
     ![选用字体](./images/2022-09-08-15-06-00.png)