# HotSwapTool

**Repository Path**: yangkaiwei/hot-swap-tool

## Basic Information

- **Project Name**: HotSwapTool
- **Description**: 一个实现java方法级热更新的工具，适用于jar包启动，运行中的java进程。可用于不停服修复线上bug。
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 4
- **Forks**: 2
- **Created**: 2020-11-12
- **Last Updated**: 2025-05-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# HotSwapTool

#### 介绍
一个实现java方法级热更新的工具，适用于jar包启动，运行中的java进程。可用于不停服修复线上bug。  
 **hotSwapTools.zip是打包好的 解压后配置下就直接可以使用。**  

#### 软件架构
classFile文件夹：用于存放要替换上去的新的class字节码文件。  
lib文件夹：用于存放引用的第三方jar，lib文件夹跟HotSwapMain.jar要在同一级目录。  
hotUpdate.properties文件：填写相关配置  
HotSwapAgent.jar：负责代理以及实际的替换操作  
HotSwapMain.jar：连接java进程传输参数，热更操作的入口。  

#### 注意事项
1、只可用于方法级更新即已有方法的方法体内修改，不支持增删类以及类结构的修改。  
2、lib下的tools.jar需要跟你热更的java进程的jdk版本一致，可以从jdk路径下复制到lib中。  

#### 安装教程
配置好直接使用，无需安装

#### 使用说明
1、修改你的目标类，并生成.class文件放入classFile文件夹。  
2、把第1步中的类全限定名填入hotUpdate.properties文件中的nameSet属性。  
3、把你要更新的java进程id填入javaPIdSet，支持多个。  
4、把HotSwapAgent.jar的路径填入hotUpdate.properties文件中的agentJarPath。  
5、把classFile文件夹的路径填入classFilePath  
6、运行指令java -jar HotSwapMain.jar ./hotUpdate.properties  


#### 其他
有遇到问题的小伙伴可以发邮件给我