Launcher
Launcher (启动器) 是一类非常有用的工具,这类工具的意义就在于设置好特定的环境以特定的参数启动特定的进程。
很多软件也用到了 launcher, 比如 Chrome,还有 Android Studio, 在 Windows 平台上,可见的是 studio.exe,
事实上,Android Studio 是基于 Intellij IDEA 开发的,IDE 代码是基于 Java 的,所谓的 studio.exe 其实就是个启动器,加载 jvm.dll 罢了。
IDEA WinLauncher 在 Github 上可以看到源码: WinLauncher
Manifest 清单是一类记录程序运行需求的文件,比如 Chrome 就有启动清单:
Chrome 的清单主要是设置了启动画面以及 Logo 信息。
从 Windows XP 开启,Windows 引入了 manifest 文件,格式基于 XML,记录了一些 依赖组件,隔离信息等,比如下面的一个清单,
requestedPrivileges 表示运行的权限,asInvoker 表示同父进程一样,如果是 requireAdministrator,如果父进程不是管理员则需触发 UAC 提权。
而 dpiAware 则是 DPI 缩放所需,实际上很多 Windows 应用开发商对这个一无所知。assemblyIdentity 则是一些依赖组件的信息了,
这里要求一些基本的控件,如 MessageBox Button, Edit, Combbox 等需要支持 Vista 以后的风格。
还有 .NET 应用程序,常常带有 app.exe.config 这类应该说是混合清单了,.config 文件除了保留了清单功能,(比如这里有指定 .NET 版本)
还支持配置信息,应用程序可以通过 ConfigurationManager 读取配置信息。
ConfigurationManager
Using System.Configuration.ConfigurationManager Example (C#)
LD 补全的 Launcher
一般而言,Linux 进程依赖的 so 文件,如果不是通过 dlopen 动态加载的,都需要放到默认的 library 目录,也就是 /usr/lib, /usr/local/lib,
或者是通过 export 命令设置 LD PATH,然后从 Shell 或 Shell 脚本启动进程。
export LD_LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/opt/lib
比如 google chrome , p4merge 等大多是写一个 launcher 脚本。新的启动器基于 C++ 实现,使用 TOML 格式文件作为清单文件。
TOML 格式清单
TOML (Tom’s Obvious, Minimal Language) 是 Github 联合创始人 Tom Preston-Werner 设计的一种极简的配置文件,格式类似于 ini, 但比 ini 严格,
支持整数,浮点,字符串,数组,布尔值,表格,时间日期。解析起来非常方便。主页 Github TOML
TOML 格式清单如下:
这里只设置了 LibraryPath Path Binary 。
清单的环境变量解析
在上面的清单中,Path=”${OWNERDIR}/../bin”, 这需要解析,OWNERDIR 代表一个环境变量,这里是内置的,表示程序 launcher 自身的目录。
环境变量的解析如下:
启动器的实现
启动器启动后,查找清单文件,清单文件文件名为 launcher.manifest , 要作为其他进程的启动器,只需要重命名和修改清单文件即可。
Launcher 随后解析清单文件,并读取 LibraryPath, Path, Binray 等属性,设置好环境变量,最后通过 execvp 启动进程,输入的参数就是启动器的全部参数。
Java Service Native Launcher
由于工作需要,我曾经写过一个 Shell 的 Java 服务启动器。如果不用第三方启动器,直接使用 JVM 官方启动器 java,
需要输入很长的命令。比如运行 hello.jar 并传递参数,如下:
java -jar hello.jar world
如果运行的是一些服务,则可能是这样的:
java -server -Xms512m -Xmx512m -jar com.fuck.service.jar –poolsize=24 –ip=192.168.1.12
很多时候,Java 开发者会使用 shell(batch) 脚本,或者第三方启动器来规避这些麻烦。
Java Service Manifest
绝大多数人并不喜欢冗长的命令,我也不例外。
在设计 Java Launcher 的时候,我采用 TOML 格式作为启动器清单格式,文件格式如下
在这个清单文件中,我设计了两种模式,第一个是基础模式,也就是 IsService 为 false 的时候,这个时候,程序只会读取 Runtime 一节
的所有配置信息。
- JDKPath 读取 jdk 所在目录,并查找到 libjvm.so 的位置。
- Package 是运行的 Jar 包的路径,也就是 MainClass 所在的Jar 包。
- VMoptions 是 Java 虚拟机 运行参数, ClassPath 是 Jar 包所在目录。
在 基础模式中,所有输入的参数除了 Argv~0, 其他的参数都会被传递给 Java MainClass 。
jsrv helloworld
假如 Package 是 hello.jar, 等价于:
java -Xms512m -Xmx512m -jar hello.jar helloworld
另一种是 服务模式 ,这种模式并不支持从命令行输入参数。当 IsService 为 true 时,启动器读取 Service 节的信息.
- IsDaemon 表示启动器是否以 守护进程的模式运行
- EnableSignal 表示开启 -s stop -s restart 参数
- PidFile 是记录守护进程 pid 的临时文件
- Stdout 是 stdout 重定向。
- Stderr 是 stderr 重定向
- DefaultArgs 这个数组是要传给 MainClass 的参数。
启动一个进程作为守护进程时,你需要将日志输出到文件。
一般而言,启动一个守护进程,先需要 fork 出一个子进程,然后退出父进程。
通过 setsid() 函数调用,让 init 进程收养它,使用 umask 设置默认权限,后面重定向标准输入输出,关闭文件句柄即可.
如果在 Windows 上运行一个守护进程,除了作为一个 Windows Service 还可以通过 WinMain 启动,在后台运行,如果从 main 启动,
就需要关闭控制台,代码如下:
启动器的处理流程可以借鉴上面的 LD 补全 启动器,在读取清单时,解析完 Runtime 一节后,读取 Runing.IsService 的信息,
如果不为真,则返回,这时候执行的是基础模式,否则,继续读取 Service 一节的信息。
返回值如下:
如果是服务模式还需要解析命令行参数,参数帮助信息如下:
解析完毕后,最后启动 JVM,执行代码并没有多少不同,执行 MainClass 的函数分别如下:
JVM 的启动流程
各个平台上的 java 以及 Windows 平台的 javaw 依然也只是 JVM 的一个启动器,这类程序需要通过调用 jvm.dll 或者 libjvm.so 导出的
函数来启动 JVM。
清单中设置了 JDKPath 信息,在 Linux 中,以 jdk8 为例,64位系统 libjvm.so 是 $JDKPath/jre/lib/amd64/server/libjvm.so,
如果找不到 libjvm.so, 启动器还会从 /usr/lib/libjvm.so 。
找到 libjvm.so 后,可以使用 dlopen 打开一个动态库句柄,dlsym 查找 Symbol, 获得函数地址,在 Windows 中 分别是 LoadLibrary 和 GetProcAddress
函数大致如下:
成功得到 JNI_CreateJavaVM 函数指针后,就该设置 JavaVMOption 类型变量,上面的 清单中的 VMOptions 要依次绑定到 JavaVMOption,
ClassPath 目录下的 jar 包,以及 Package 要绑定到 -Djava.class.path 上, 然后调用 JNI_CreateJavaVM 函数指针,获得一个 JavaVM 对象和
JNIEnv 对象。
Jar 包是基于 zip 格式的文件,内部的 META-INF/MANIFEST.MF 这一清单文件记录了 清单版本,Main-Class 以及 Class-Path, 可以从 Jar 包里面读取
MainClass 。
我使用了 Github 用户 slyfoxza slyfoxza/minecraftd 的 JarReader来获取
MainClass,不过遗憾的是,通过 JarReader 得到的 MainClass 是用 ‘.’ 区分的,而 FindClass 需要 ‘/’ 区分。 我是用了一个帮助函数来替换所有的 点。
使用 env->FindClass 获取 MainClass, 类型为 jclass, 使用 env->GetStaticMethodID 获取 MainClass 的方法 main, 后面就是将 参数转成 JVM String[] 类型
随后调用静态方法即可, 大致如下:
程序退出的时候需要析构这些对象。
实际上一个大致的 JVM Launcher 也就这样了。