キャラクターなんとかJ (CharacterManaJ) Version 1.0.0.2

• 2024/2/22
• https://sourceforge.net/projects/charactermanaj/

english

動作環境

想定する動作環境は以下のとおりです。(保証ではありません。)

• Windows
  • Windows 11 (x64)
  • Windows 10 (x64)
• macOS
  • macOS 10.15 Catalina 以降
  • intel x64 macOS 13.6.4 Ventura でビルドされています。
• Linux
  • Ubuntu 22.04 (x64)
  • MintLinux 21.3 (xfce4/x64)

原理的には、openjdk-17-jdk が動作する環境であれば動作する可能性があります。ただし、macOSはxcode15.2でx64をターゲットとしてjavaランチャをビルドしているため、macOS10.15以降でないと動作しません。(ランチャを使わずjarファイル単体で動作させることは可能かもしれません。)

主な変更点

Ver0.10からの変更点

• Java17で動作するように更新した。
  • Java同梱版でない場合、予めシステムにJava17のランタイムのインストールを必要とします。
  • Java同梱版の場合、本アプリケーション専用のJavaランタイムのサブセット(jlink)が使われます。これは本アプリケーションのみ使用するもので、システムに影響を与えません。
• カラーパターン登録機能の追加した
  • カラー設定ダイアログで、設定値に名前をつけることができるようになりました。
  • この設定は color-patterns.xml としてキャラクターデータディレクトリと同じ場所に保存されます。
• appConfig設定ファイルは差分のみ保存するように変更した
  • 従来、設定値を変更した場合はすべての設定項目がxmlファイルとして保存されていましたが、今バージョンからデフォルト値と異なる項目だけ保存するようになりました。
• 設定ファイルの保存場所の整理した
  • Linuxの場合は、標準でXDGに合わせた
• レイアウトの微調整した
• ランチャ部のネイティブコードを更新した
  • javaの探索機能を変更、バージョンを確認するようにした。
  • 以下の場所にあるJAVAが探索され、javaw.exeがあり、かつ、バージョンが一致するものが選択されます。
    • レジストリの HKLM\SOFTWARE\JavaSoft\JDK の下にあるもの
    • %ProgramFiles%\\Eclipse Adoptium
    • %ProgramFiles%\\Amazon Corretto
    • %ProgramFiles%\\Microsoft
    • 環境変数%PATH%のいずれかのフォルダの中にあるjavaw.exe
  • 該当するjavaが見つからない場合は手動選択ダイアログが表示されます。
  • 選択されたJAVAランタイムは、C:\Users\USERNAME\AppData\Local\CharacterManaJ\launcher.cfg に記録され、次回以降は、この設定値が使用されます。
  • 異なるJAVAに選択しなおしたい場合は、このファイルを修正するか削除してください。
• java起動パラメーターファイルのカスタマイズに対応した
  • C:\Users\USERNAME\AppData\Local\CharacterManaJ\jvm_options というテキストファイルにJAVAの起動パラメータを記述できます。
  • 従来どおり、exeの下にあるcharactermanaj.iniファイルも有効です。
  • たとえば、JAVAが使用するメモリ量を指定する場合、-Xmx512m と記載した場合は、メモリ512MBytesをヒープメモリとします。
  • 何も指定しない場合はJAVAランタイムが自動的に割り当てます。
  • 割り当てられているメモリ量は、ヘルプのAboutメニューのSystemタブで確認できます。(0.98、0.99ではiniファイルが小さめの初期値が指定されていましたが、1.0ではメモリは指定されていません。)
• ログ出力形式の調整した
• インポート時にダウンロードURLを指定した場合、ダウンロードファイルを残すように変更した
• ダウンロード先が未知のURLである場合、アクセスする前に確認ダイアログを表示するように変更した

ダウンロード

Java17がインストールされており、その場所を知っている場合以外は、JAVA同梱タイプのダウンロードをオススメします。

この同梱されているJavaはシステムにはインストールされず、システムには影響を与えません。本アプリケーションの実行にのみ使用されます。

Java同梱版以外を使用する場合には、起動時にJava17のパスを指定する必要があります。

また、JAVAランチャを使わず、独自の起動スクリプトを書きたい場合、CharacterManaJ.jar 単体でダウンロードしてください。このjarが、本アプリケーション本体です。原理的には、openjdk17が動作する環境であれば、本アプリケーションは動作すると考えられます。

Windows用

• CharacterManaJ_1.0.0.2_with_jlink.zip (Java17同梱)
• CharacterManaJ_1.0.0.2.zip

jlink版は、Javaランタイムから本アプリケーションが必要とするモジュールだけを取り出したランタイムが同梱されています。 この同梱されているJavaはシステムにはインストールされず、システムには影響を与えません。本アプリケーションの実行にのみ使用されます。

Java同梱版以外を使用する場合には、マイクロソフト、Eclipse Temurin、Amazon Corretoなど、お好みのディストリビューションから、Java17(もしくは、それ以降)を、あらかじめインストールしてください。

• Microsoft Build of OpenJDK 17
• Eclipse Temurin
• Amazon Corretto
• (これらのディストリビューション以外でもopenjdkをベースにしていれば動作すると思いますが、確認はしていません。)

いずれもzipを展開するだけで、インストーラーなどはありません。展開されたファイルの中にある、CharacterManaJ.exeを直接実行してください。これがjavaランチャーとなっています。

(上級者向け: CharacterManaJ.exeは、MinGWのgcc(g++)で書かれているJAVAランチャです。もし、自分で起動スクリプトを書きたい場合は、java -p mods -m charactermanaj.CharacterManaJ がエントリポイントとなっています。)

MacOS用

• CharacterManaJ_1.0.0.2_with_jre.dmg (Java17同梱)
• CharacterManaJ_1.0.0.2.dmg

jre版は、Javaランタイムから本アプリケーションが必要とするモジュールだけを取り出したランタイムが同梱されています。 この同梱されているJavaはシステムにはインストールされず、システムには影響を与えません。本アプリケーションの実行にのみ使用されます。

Java同梱版以外を使用する場合には、マイクロソフト、Eclipse Temurin、Amazon Corretoなど、お好みのディストリビューションから、Java17(もしくは、それ以降)を、あらかじめインストールしてください。

• Eclipse Temurin
• Amazon Corretto
• (これらのディストリビューション以外でもopenjdkをベースにしていれば動作すると思いますが、確認はしていません。)

いずれもdmgを開くと、実行できるアプリケーションバンドルとなっています。お好みの場所に移動してお使いください。

(上級者向け: CharacterManaJ.app内には、xcodeのObjectiveCで書かれているJAVAランチャがあります。これは、/usr/libexec/java_homeのコマンドを使って、システムにインストールされているJAVA_HOMEを探索するなどの処理を行っています。もし、自分で起動スクリプトを書きたい場合は、java -p mods -m charactermanaj.CharacterManaJ がエントリポイントとなっています。)

Linux用

• CharacterManaJ_1.0.0.2-runtime.deb
• CharacterManaJ_1.0.0.2.deb

runtime版は、Javaランタイムから本アプリケーションが必要とするモジュールだけを取り出したランタイムが同梱されています。 この同梱されているJavaはシステムにはインストールされず、システムには影響を与えません。本アプリケーションの実行にのみ使用されます。

Java同梱版以外を使用する場合には、あらかじめ、Java17(openjdk-17-jdk など)のインストールが必要です。

sudo apt install openjdk-17-jdk

debパッケージは、以下のようにインストールできます。

sudo dpkg -i CharacterManaJ_1.0.0.2-runtime.deb

debパッケージ版は、システムの以下の場所に本アプリケーションと関連ファイルをインストールします。

• /usr/share/charactermanaj/ 下に本体jar(jlinkも)がインストールされます。
• /usr/bin/charactermanaj 起動するためのシェルスクリプト
• `/usr/share/applications/charactermanaj-CharacterManaJ.desktop メニュー
• /usr/share/man/man1/charactermanaj.1.gz (およびja) ヘルプ
• /usr/share/menu/CharacterManaJ x11用メニュー
• /usr/share/pixmaps/charactermanaj/icon.xpm アイコン画像

アンインストールする場合は、以下のようにします。

sudo dpkg -r CharacterManaJ

Javaランチャを使用しない場合

• CharacterManaJ-1.0.0.2.jar

本アプリケーションは現状1つのjarだけで動作できます。

java -p mods -m charactermanaj.CharacterManaJ

のようにjarファイルを置いたモジューパスと、モジュール名 charactermanaj.CharacterManaJ を指定することで起動します。

また、本バージョンでは以前の非モジュール版としても引き続き起動できます。

java -jar CharacterManaJ-1.0.0.2.jar

のように実行可能jarとして起動することもできます。

ご意見・不具合報告など

以下にご連絡ください。

https://sourceforge.net/p/charactermanaj/discussion/

---

english_translation

Operating Environment

The assumed operating environment is as follows. (Not guaranteed.)

• Windows
  • Windows 11 (x64)
  • Windows 10 (x64)
• macOS
  • macOS 10.15 Catalina or later
  • Built on intel x64 macOS 13.6.4 Ventura.
• Linux
  • Ubuntu 22.04 (x64)
  • MintLinux 21.3 (xfce4/x64)

In principle, it may work in any environment where openjdk-17-jdk operates. However, since the macOS Java launcher is built targeting x64 with xcode15.2, it will not function on macOS versions earlier than 10.15. (It might be possible to run it using just the jar file without the launcher.)

Key Changes

Changes from Ver0.10

• Updated to run on Java17.
  • If not using the bundled Java version, installing the Java17 runtime on your system in advance is required.
  • For the bundled Java version, a subset of the Java runtime specific to this application (jlink) is used. It is exclusive to this application and does not affect the system.
• Added a color pattern registration feature
  • It is now possible to name the settings values in the color settings dialog.
  • These settings are saved in the same location as the character data directory as color-patterns.xml.
• Changed the appConfig configuration file to save only the differences
  • Previously, changing settings would save all settings items as an XML file, but from this version, only items that differ from the default values are saved.
• Organized the location of configuration file storage
  • For Linux, standard according to XDG
• Fine-tuned the layout
• Updated the launcher's native code
  • Modified the Java search functionality to include version checking.
  • JAVA will be searched for in the following locations, and javaw.exe will be selected if it exists and the version matches:
    • Under HKLM\SOFTWARE\JavaSoft\JDK in the registry
    • %ProgramFiles%\\Eclipse Adoptium
    • %ProgramFiles%\\Amazon Corretto
    • %ProgramFiles%\\Microsoft
    • In any folder within the environment variable %PATH% that contains javaw.exe
  • If the appropriate Java is not found, a manual selection dialog will be displayed.
  • The selected JAVA runtime is recorded in C:\\Users\\USERNAME\\AppData\\Local\\CharacterManaJ\\launcher.cfg, and this setting will be used thereafter.
  • If you want to select a different JAVA, modify or delete this file.
• Supported customization of the java launch parameter file
  • You can write JAVA's launch parameters in a text file named C:\\Users\\USERNAME\\AppData\\Local\\CharacterManaJ\\jvm_options.
  • As before, the charactermanaj.ini file under the exe is also valid.
  • For example, specifying -Xmx512m sets the memory to 512MBytes of heap memory.
  • If nothing is specified, the JAVA runtime will automatically allocate.
  • The amount of memory allocated can be checked in the System tab of the Help's About menu. (In versions 0.98 and 0.99, the ini file specified a smaller default value, but in 1.0, no memory is specified.)
• Adjusted the log output format
• Changed to keep the download file when specifying a download URL at import
• Changed to display a confirmation dialog before accessing an unknown URL for downloads

Download

We recommend downloading the version bundled with JAVA unless you have Java17 installed and know its location.

The Java included in this bundle is not installed on the system and does not affect the system. It is used solely for running this application.

If using a version other than the Java-bundled one, you will need to specify the path to Java17 at startup.

Furthermore, if you wish to write your own startup script without using the JAVA launcher, please download CharacterManaJ.jar alone. This jar is the main body of the application. In principle, the application is considered to operate in any environment where openjdk17 is functional.

For Windows

• CharacterManaJ_1.0.0.2_with_jlink.zip (Java17 bundled)
• CharacterManaJ_1.0.0.2.zip

The jlink version comes with a runtime that extracts only the modules required by this application from the Java runtime. This bundled Java does not install on the system and does not affect the system. It is used only for running this application.

If using a version other than the Java-bundled one, please install Java17 (or later) from your preferred distribution such as Microsoft, Eclipse Temurin, Amazon Corretto, etc., in advance.

• Microsoft Build of OpenJDK 17
• Eclipse Temurin
• Amazon Corretto
• (It is expected to work with other distributions based on openjdk, but this has not been confirmed.)

In all cases, just unzip the file, no installer is required. Run CharacterManaJ.exe directly from the extracted files. This acts as the java launcher.

(For advanced users: CharacterManaJ.exe is a JAVA launcher written in MinGW's gcc(g++). If you want to write your own startup script, java -p mods -m charactermanaj.CharacterManaJ is the entry point.)

For MacOS

• CharacterManaJ_1.0.0.2_with_jre.dmg (Java17 bundled)
• CharacterManaJ_1.0.0.2.dmg

The jre version comes with a runtime that extracts only the modules required

by this application from the Java runtime. This bundled Java does not install on the system and does not affect the system. It is used only for running this application.

If using a version other than the Java-bundled one, please install Java17 (or later) from your preferred distribution such as Eclipse Temurin, Amazon Corretto, etc., in advance.

• Eclipse Temurin
• Amazon Corretto
• (It is expected to work with other distributions based on openjdk, but this has not been confirmed.)

Opening the dmg will give you an executable application bundle. Move it to your preferred location to use.

(For advanced users: Inside CharacterManaJ.app, there is a JAVA launcher written in Xcode's ObjectiveC. It uses the /usr/libexec/java_home command to search for JAVA_HOME installed on the system, among other processes. If you want to write your own startup script, java -p mods -m charactermanaj.CharacterManaJ is the entry point.)

For Linux

• CharacterManaJ_1.0.0.2-runtime.deb
• CharacterManaJ_1.0.0.2.deb

The runtime version comes with a runtime that extracts only the modules required by this application from the Java runtime. This bundled Java does not install on the system and does not affect the system. It is used only for running this application.

If using a version other than the Java-bundled one, installing Java17 (openjdk-17-jdk, etc.) in advance is required.

sudo apt install openjdk-17-jdk

The deb package can be installed as follows:

sudo dpkg -i CharacterManaJ_1.0.0.2-runtime.deb

The deb package version installs the application and related files in the system at the following locations:

• Installed under /usr/share/charactermanaj/ are the main jar (jlink included).
• /usr/bin/charactermanaj for launching the script
• /usr/share/applications/charactermanaj-CharacterManaJ.desktop for the menu
• /usr/share/man/man1/charactermanaj.1.gz (and ja) for help
• /usr/share/menu/CharacterManaJ for the X11 menu
• /usr/share/pixmaps/charactermanaj/icon.xpm for the icon image

To uninstall, do the following:

sudo dpkg -r CharacterManaJ

When Not Using the Java Launcher

• CharacterManaJ-1.0.0.2.jar

The application currently can operate with just one jar file.

java -p mods -m charactermanaj.CharacterManaJ

It starts by specifying the module path where the jar file is placed and the module name charactermanaj.CharacterManaJ.

Moreover, this version can also be launched as a non-module version, as before.

java -jar CharacterManaJ-1.0.0.2.jar

It can also be executed as a runnable jar in this manner.

Feedback and Bug Reporting

Please contact us here.

https://sourceforge.net/p/charactermanaj/discussion/

END