From 656407723a878e43da65f8d667b761ecec5ba319 Mon Sep 17 00:00:00 2001 From: monitor1394 Date: Thu, 24 Oct 2019 08:45:02 +0800 Subject: [PATCH] =?UTF-8?q?=E5=8F=91=E5=B8=831.0.0=E7=89=88=E6=9C=AC?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Assets/XCharts/README.md | 51 ++++++++++++++++++++++++++++++++++- Assets/XCharts/README.md.meta | 7 +++++ Assets/XCharts/package.json | 16 ++++++----- Doc/教程：5分钟上手XCharts.md | 12 ++++++++- README.md | 37 +++++++++---------------- 5 files changed, 90 insertions(+), 33 deletions(-) create mode 100644 Assets/XCharts/README.md.meta diff --git a/Assets/XCharts/README.md b/Assets/XCharts/README.md index a00ce769..389d3cee 100644 --- a/Assets/XCharts/README.md +++ b/Assets/XCharts/README.md @@ -1,2 +1,51 @@ +# XCharts -A powerful, easy-to-use, configurable charting and data visualization library for Unity. \ No newline at end of file +A powerful, easy-to-use, configurable charting and data visualization library for Unity. + +一款基于`UGUI`的功能强大、易用、参数可配置的数据可视化图表插件。支持折线图、柱状图、饼图、雷达图、散点图、热力图等常见图表。 + +## 特性 + +* 内置丰富示例和模板，参数可视化配置，效果实时预览，纯代码绘制。 +* 支持折线图、柱状图、饼图、雷达图、散点图、热力图等常见图表。 +* 支持直线图、曲线图、面积图、阶梯线图等折线图。 +* 支持并列柱图、堆叠柱图、堆积百分比柱图、斑马柱图等柱状图。 +* 支持环形图、玫瑰图等饼图。 +* 支持折线图—柱状图、散点图-折线图等组合图。 +* 支持实线、曲线、阶梯线、虚线、点线、点划线、双点划线等线条。 +* 支持自定义主题，内置主题切换。 +* 支持自定义图表内容绘制，提供绘制点、直线、曲线、三角形、四边形、圆形、环形、扇形、边框、箭头等绘图API。 +* 支持PC端和手机端上的数据筛选、视图缩放、细节展示等交互操作。 +* 支持万级大数据绘制。 + +## 使用 + +* 本项目在`Unity 2018.3.14f1`和`.Net 3.5`下开发，在 `Unity 5`、`Unity 2017`、`Unity 2019`上测试正常。理论上可运行于任何支持`UGUI`的`Unity`版本。 +* 通过下载源码或`unitypackage`包导入到你的项目中。如果你是`2018.3`及以上版本，强烈建议通过`Package Manager`的`Git`来导入包： + + 1. 打开`Packages`目录下的`manifest.json`文件，在`dependencies`下加入： + + ``` json + "com.monitor1394.xcharts": "https://github.com/monitor1394/unity-ugui-XCharts.git#package", + ``` + + 2. 回到`Unity`，可能会花3到5分钟进行下载和编译，成功后就可以开始使用`XCharts`了。 + 3. 如果要删除`XCharts`，删除掉1步骤所加的内容即可。 + 4. 如果要更新`XCharts`，删除`manifest.json`文件的`lock`下的`com.monitor1394.xcharts`相关内容即会从新下载编译。在 `Component -> XCharts -> Check For Update`可以检测是否有新版本可更新。 + +* 在Editor上快速创建一个图表： + + 1. 在`Canvas`下通过`Create Empty`创建一个空`gameObject`，命名为 `line_chart`。 + 2. 通过菜单栏 `Component->XCharts->LineChart` 或者 `Inspector` 视图的 `Add Component` 添加 `LineChart` 脚本。一个简单的折线图就出来了。 + 3. `Inspector` 视图下可以调整各个组件的参数，`Game` 视图会实时反馈调整的效果。各个组件的详细参数说明可查阅[XCharts配置项手册](https://github.com/monitor1394/unity-ugui-XCharts/blob/master/Assets/XCharts/Documentation/XCharts配置项手册.md)。 + +* 更多的代码动态控制的例子请参考[教程：5分钟上手XCharts](https://github.com/monitor1394/unity-ugui-XCharts/blob/master/Doc/教程：5分钟上手XCharts.md) 。 + +## 文档 + +* [XCharts主页](https://github.com/monitor1394/unity-ugui-XCharts) +* 常见问题看这里☞ [XCharts问答](https://github.com/monitor1394/unity-ugui-XCharts/blob/master/Assets/XCharts/Documentation/XCharts问答.md) +* 接口文档看这里☞ [XChartsAPI手册](https://github.com/monitor1394/unity-ugui-XCharts/blob/master/Assets/XCharts/Documentation/XChartsAPI.md) +* 参数配置看这里☞ [XCharts配置项手册](https://github.com/monitor1394/unity-ugui-XCharts/blob/master/Assets/XCharts/Documentation/XCharts配置项手册.md) +* 更新日志看这里☞ [XCharts更新日志](https://github.com/monitor1394/unity-ugui-XCharts/blob/master/Assets/XCharts/CHANGELOG.md) +* 新手教程看这里☞ [教程：5分钟上手XCharts](https://github.com/monitor1394/unity-ugui-XCharts/blob/master/Doc/教程：5分钟上手XCharts.md) diff --git a/Assets/XCharts/README.md.meta b/Assets/XCharts/README.md.meta new file mode 100644 index 00000000..760d09c3 --- /dev/null +++ b/Assets/XCharts/README.md.meta @@ -0,0 +1,7 @@ +fileFormatVersion: 2 +guid: 393c8e8ab781b4041b141f93eb407380 +TextScriptImporter: + externalObjects: {} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/XCharts/package.json b/Assets/XCharts/package.json index fef002b9..7e681657 100644 --- a/Assets/XCharts/package.json +++ b/Assets/XCharts/package.json @@ -1,16 +1,18 @@ { "name": "com.monitor1394.xcharts", "displayName": "XCharts", - "version": "1.0.1", + "version": "1.0.0", "unity": "2018.3", - "description": "A charting and data visualization library for Unity. 一款基于UGUI的数据可视化图表报表插件。", + "description": "A charting and data visualization library for Unity.", "keywords": [ - "XCharts", - "Chart", - "Graphic", - "DataVisualization" + "unity", + "chart", + "xcharts", + "graphic", + "visualization", + "data-visualization" ], - "category": "UI", + "category": "chart", "repository": { "type": "git", "url": "git+https://github.com/monitor1394/unity-ugui-XCharts.git" diff --git a/Doc/教程：5分钟上手XCharts.md b/Doc/教程：5分钟上手XCharts.md index bdbcf32f..eaa14479 100644 --- a/Doc/教程：5分钟上手XCharts.md +++ b/Doc/教程：5分钟上手XCharts.md @@ -12,7 +12,17 @@ 如果你只是想运行 `Demo` 查看效果，可以在 [Github](https://github.com/monitor1394/unity-ugui-XCharts)上的 [Clone or download](https://github.com/monitor1394/unity-ugui-XCharts/archive/master.zip)下载最新版本或去 [release](https://github.com/monitor1394/unity-ugui-XCharts/releases)下载稳定版本，将源码工程解压后用`unity`打开即可。 - 如果你要将 `XCharts` 加入你的项目中，可以在[Github](https://github.com/monitor1394/unity-ugui-XCharts)上下载最新的 [release](https://github.com/monitor1394/unity-ugui-XCharts/releases)稳定版本，将 `XCharts-vx.x.x.unitypackage` 通过 Unity 导入到你的项目中，或下载 Source code 解压后将内部的 `XCharts` 文件夹拷贝到你项目的 `Assets` 目录下。 +如果你要将 `XCharts` 加入你的项目中，可以在[Github](https://github.com/monitor1394/unity-ugui-XCharts)上下载最新的 [release](https://github.com/monitor1394/unity-ugui-XCharts/releases)稳定版本，将 `XCharts-vx.x.x.unitypackage` 通过 Unity 导入到你的项目中，或下载 Source code 解压后将内部的 `XCharts` 文件夹拷贝到你项目的 `Assets` 目录下。 + +如果你是Unity 2018.3版本以上，强烈建议通过Package Manager来安装XCharts包，具体操作步骤如下： + + 1. 打开`Packages`目录下的`manifest.json`文件，在`dependencies`下加入： + ``` + "com.monitor1394.xcharts": "https://github.com/monitor1394/unity-ugui-XCharts.git#package", + ``` + 2. 回到`Unity`，可能会花3到5分钟进行下载和编译，成功后就可以开始使用`XCharts`了。 + 3. 如果要删除`XCharts`，删除掉1步骤所加的内容即可。 + 4. 如果要更新`XCharts`，删除`manifest.json`文件的`lock`下的`com.monitor1394.xcharts`相关内容即会重新下载编译。在 `Component -> XCharts -> Check For Update`可以检测是否有新版本可更新。 ## 添加一个简单图表 diff --git a/README.md b/README.md index 40c14d4b..173e7b4c 100644 --- a/README.md +++ b/README.md @@ -7,7 +7,7 @@ A powerful, easy-to-use, configurable charting and data visualization library for Unity. -一款基于`UGUI`的功能强大、易用、参数可配置的数据可视化图表报表`Unity`插件。支持折线图、柱状图、饼图、雷达图、散点图、热力图等常见图表。 +一款基于`UGUI`的功能强大、易用、参数可配置的数据可视化图表插件。支持折线图、柱状图、饼图、雷达图、散点图、热力图等常见图表。 [XCharts问答](https://github.com/monitor1394/unity-ugui-XCharts/blob/master/Assets/XCharts/Documentation/XCharts问答.md) [XChartsAPI手册](https://github.com/monitor1394/unity-ugui-XCharts/blob/master/Assets/XCharts/Documentation/XChartsAPI.md) @@ -17,8 +17,6 @@ A powerful, easy-to-use, configurable charting and data visualization library fo ## 特性 ---- - * 内置丰富示例和模板，参数可视化配置，效果实时预览，纯代码绘制。 * 支持折线图、柱状图、饼图、雷达图、散点图、热力图等常见图表。 * 支持直线图、曲线图、面积图、阶梯线图等折线图。 @@ -33,8 +31,6 @@ A powerful, easy-to-use, configurable charting and data visualization library fo ## 截图 ---- - @@ -44,8 +40,6 @@ A powerful, easy-to-use, configurable charting and data visualization library fo ## 术语 ---- - XCharts的图表由组件和数据组成。不同的组件和数据可以组合成不同类型的图表。组件分为主组件和子组件，主组件包含子组件。 `XCharts` 支持的主组件： @@ -106,10 +100,16 @@ XCharts的图表由组件和数据组成。不同的组件和数据可以组合 ## 使用 ---- +* 本项目在`Unity 2018.3.14f1`和`.Net 3.5`下开发，在 `Unity 5`、`Unity 2017`、`Unity 2019`上测试正常。理论上可运行于任何支持`UGUI`的`Unity`版本。 +* 通过下载源码或`unitypackage`包导入到你的项目中。如果你是`2018.3`及以上版本，强烈建议通过`Package Manager`的`Git`来导入包： + 1. 打开`Packages`目录下的`manifest.json`文件，在`dependencies`下加入： + ``` json + "com.monitor1394.xcharts": "https://github.com/monitor1394/unity-ugui-XCharts.git#package", + ``` + 2. 回到`Unity`，可能会花3到5分钟进行下载和编译，成功后就可以开始使用`XCharts`了。 + 3. 如果要删除`XCharts`，删除掉1步骤所加的内容即可。 + 4. 如果要更新`XCharts`，删除`manifest.json`文件的`lock`下的`com.monitor1394.xcharts`相关内容即会从新下载编译。在 `Component -> XCharts -> Check For Update`可以检测是否有新版本可更新。 -* 本项目在`Unity 2017.4.27f1`和`.Net 3.5`下进行开发测试。理论上可运行任何支持`UGUI`的`Unity`版本。 -* 通过源码或`unitypackage`包导入到你的项目中。 * 在Editor上快速创建一个图表： 1. 在`Canvas`下通过`Create Empty`创建一个空`gameObject`，命名为 `line_chart`。 @@ -120,8 +120,6 @@ XCharts的图表由组件和数据组成。不同的组件和数据可以组合 ## 文档 ---- - * 常见问题看这里☞ [XCharts问答](https://github.com/monitor1394/unity-ugui-XCharts/blob/master/Assets/XCharts/Documentation/XCharts问答.md) * 接口文档看这里☞ [XChartsAPI手册](https://github.com/monitor1394/unity-ugui-XCharts/blob/master/Assets/XCharts/Documentation/XChartsAPI.md) * 参数配置看这里☞ [XCharts配置项手册](https://github.com/monitor1394/unity-ugui-XCharts/blob/master/Assets/XCharts/Documentation/XCharts配置项手册.md) @@ -130,8 +128,6 @@ XCharts的图表由组件和数据组成。不同的组件和数据可以组合 ## 结构 ---- - ``` js . ├── Demo // Demo @@ -266,31 +262,24 @@ XCharts的图表由组件和数据组成。不同的组件和数据可以组合 ## 更新日志 ---- - [更新日志](https://github.com/monitor1394/unity-ugui-XCharts/blob/master/Assets/XCharts/CHANGELOG.md) ## Licenses ---- - [MIT License](https://github.com/monitor1394/unity-ugui-XCharts/blob/master/Assets/XCharts/LICENSE.md) ## 开发交流 ---- 邮箱：monitor1394@gmail.com QQ群：XCharts交流群（`202030963`） VIP群：XCharts技术支持VIP群（`867291970`） ## 捐助 ---- +如果这个项目对您有帮助，请右上方点 `Star` 予以支持！也欢迎各方任何形式的捐助，任何金额的赞助都将非常感谢。 -如果这个项目对您有帮助，请点 star 予以支持！也欢迎各方任何形式的捐助，任何金额的赞助都将非常感谢。 - -企业的高额赞助请备注留下公司名称。 +企业赞助请备注公司名称。 -如需商业技术支持，捐助280¥可加VIP群（867291970，验证信息请输入捐助的支付宝账号）。 +如需商业技术支持，捐助280¥可加VIP群（`867291970`，验证信息请输入捐助的支付宝账号）。