README.md · poethxp/kwooca

### Wooca（哇咔）

Wooca是一款用于管理SpringBoot应用运行状态的软件。开发该软件的初衷是为了让SpringBoot（或Spring Cloud）应用的开发者们可以更好的在开发工作站上运行相应的应用，因为在SpringBoot(或Spring Cloud)应用开发过程中通常需要同时运行多个SpringBoot应用程序，开发人员不得不需要通过命令行或IDE来运行这些程序，他们也经常需要在各个Shell窗口（Cmd窗口）中来回切换，甚是麻烦。

Wooca的出现，将这些应用统一在一个窗口中进行处理，同时，可以根据应用本身的特点，进行相应的参数配置，达到更好的配置管理的过程。在SpringBoot应用运行过程中，还可以通过Wooca来进行日志、CPU、内存、IO、网络吞吐等多方面的性能指标监控，及时的了解SpringBoot应用的运行状态。Wooca解放了开发人员对Shell/Cmd窗口的依赖，更加集成化的将SpringBoot/Cloud应用捆绑在一起，并对这些应该的启动参数进行统一管理，Wooca提供了一些更加友好的方式来管理这些参数，防止开发人员随意使用这些参数，而造成一些意想不到的缺陷出来。

### 软件所需要的依赖库及软件
1. wxWidget 5.3
2. Visual Studio 2017以及以上版本，支持C++，且提供了至少是Windows 10的SDK。
3. cURL
4. libzip
5. OpenSSL

为了简化使用，项目源文件中提供了具体的安装包：
https://gitee.com/poethxp/kwooca/raw/master/release/kWooka.zip
大家可以直接下载并运行。绿色，无须安装其它依赖。

### 版本0.1.0 基础功能说明

Wooca目前发布出来的版本是0.1.0。该版本实现了对Wooca的基础设想，也就是对SpringBoot应用的运行状态的管理。主要功能如下：

- 创建Wooca项目，选择一个空白的目录，即可创建一个Wooca项目，Wooca会在该目录下建立一个wooka.json的文件，以此表示该目录是一个Wooca项目的工作目录。
- 打开Wooca项目，选择一个包括了wooca.json文件的工作目录，即可进行打开。打开项目后，会将该项目所包含的所有的SpringBoot应用展示在软件的左侧列表中。
- 添加SpringBoot应用到项目，创建或打开项目后，可以通过列表上方的按钮来选择SpringBoot Fat Jar的方式来建立应用，Wooca会读取Jar中的Metadata内容，来生成对应的名称以及版本号等。
- 运行一个SpringBoot应用，双击选择应用列表中某个应用，点击启动按钮可以启动一个应用。
- 停止一个SpringBoot应用，双击选择应用列表中某个应用，如果该应用正在运行中，点击停止按钮可以停止一个应用。
- 删除一个SpringBoot应用，双击选择应用列表中某个应用，点击删除应用的按钮，可以将该应用删除。
- 启动项目中全部应用，打开Wooca项目后，可以使用工具栏中“全部启动”来启动全部的SpringBoot应用。
- 停止项目中全部应用，Wooca中应用运行后，可以使用工具栏中“全部停止”来停止全部正在运行的SpringBoot应用。
- 查看日志，首先是在Wooca项目列表中，双击你要查看的日志的应用，然后在右侧的区域中选择“日志”选项卡。

![日志查看](https://gitee.com/poethxp/kwooca/raw/master/1633679973(1).png "日志查看")

- 查看性能指标，首先是在Wooca项目列表中，双击你要查看的性能的应用，然后在右侧的区域中选择“性能监控”选项卡。可以通过界面来查看该应用的CPU使用率、内存使用率、磁盘IO、网络吞吐量、线程数变化、句柄数变化。

![性能监控图表](https://gitee.com/poethxp/kwooca/raw/master/1633680031(1).png "性能监控图表")

- Wooca项目的全局配置，打开Wooca项目后，可以通过工具栏中的“项目属性”来对项目的全局属性进行设置，如全局的JDK HOME、全局的环境变量、全局的Java应用启动参数等。
- 应用的启动参数配置，双击选择应用列表中某个应用，再选择右侧区域的“配置”选项卡，可以对JVM参数、以及应用的配置参数进行调整，如果全局配置中有相同的配置，应用的配置会覆盖全局配置。

![应用启动参数配置](https://gitee.com/poethxp/kwooca/raw/master/1633680055(1).png "应用启动参数配置")

### 运行环境
Wooca是一个独立免安装的绿色软件，因此，它的体积也就会大一点。同时，Wooca是基于Windows 10的基础进行开发的，采用了wxWidgets 3.1.5进行界面的开发。Wooca可以确保在Windows 10及其以上版本上运行。
Windows 10的用户请直接下载kWooka.exe并直接运行即可。

### 后续开发计划

Wooca后续开发在完成对目前功能的维护，确保Wooca能正常有稳定的运行的基础上，还会对其进行持续性开发，旨在让其能够提供更多的功能、能在更多的环境下运行。后续的开发将主要会集中在以下几个方面：
 
1.  **运行环境支持方面**

Wooca后续可能会提供基于macOS的版本，以及基于GTK的Linux版本

2.  **通用Java服务支持**

Wooca后续可能会提供通用的Java服务的支持，如Tomcat，ElasticSearch等。

3.  **服务器方面的支持**

在Windows下提供基于Service方式来运行Spring Boot应用的方式，在macOS或Linux下，提供基于systemctl的整合机制。
 
4.  **nginx支持**

提供对nginx的集成，这个会是大多数开发人员所需要的。同样的是将nginx常用的指令进行配置化，方便开发人员完成对nginx的配置。
 
5.  **Maven/Gradle支持**

Wooca将可以直接从Maven/Gradle仓库中下载SpringBoot应用并运行之。
 
6.  **API 记录器**

Wooca作为一个特殊的代理方式，来实现将所有的访部了项目的API请求都记录下来，并可以重放。

### 开放源代码

对于该项目的源代码，我们采用有偿方式进行开源，希望使用该项目的源码的请进行捐助！谢谢。

### 问题与建议

如果您有什么建议或使用中有会问题，您可以通过发送邮件到longzou@hotmail.com，我们将会第一时间了解并为您解答。

poethxp/kwooca

简介

发行版 (1)

贡献者

近期动态

poethxp/kwooca .gitee-modal { width: 500px !important; }

简介

发行版 (1)

开源评估指数源自 OSS-Compass 评估体系，评估体系围绕以下三个维度对项目展开评估：

贡献者

近期动态

搜索帮助

poethxp/kwooca