クイックスタート
osbxl をすぐに始めるためのガイド
1 評価版をダウンロード
本HPのダウンロードページから、お使いの言語・OSに合わせた評価版をダウンロードしてください。
2 モジュールをインストール
ダウンロードしたモジュールをインストールします。
各言語の対応OS・サポートバージョンの詳細は 製品仕様 をご確認ください。
Node.js
Node 18 以上に対応しています。
npm install ./nodeosbxl-1.5.1.tgzPython
Python 3.8 以上に対応しています。Python 3.8〜3.11 と Python 3.12以上でモジュールが分かれますので、お使いの OS およびバージョンに合わせた wheel ファイルを選択してください。
# (例) Python 3.11 (Linux) の場合
pip install ./pyosbxl-1.5.1-cp311-cp311-linux_x86_64.whl
# (例) Python 3.12以上 (Linux) の場合 (abi3 対応)
pip install ./pyosbxl-1.5.1-cp312-abi3-linux_x86_64.whlJava
Java 8 以上、および依存関係のある JavaCPP (1.5.14 推奨) が必要です。
直接クラスパスを指定する場合
javac -cp ".:osbxl-1.5.1.jar:javacpp-1.5.14.jar" Main.java
java -cp ".:osbxl-1.5.1.jar:javacpp-1.5.14.jar" MainMaven (pom.xml) を使用する場合の例
<dependencies>
<!-- OSBXL (ローカルJARまたはリポジトリ) -->
<dependency>
<groupId>com.osboffice.osbxl</groupId>
<artifactId>osbxl</artifactId>
<version>1.5.1</version>
<scope>system</scope>
<systemPath>${project.basedir}/libs/osbxl-1.5.1.jar</systemPath>
</dependency>
<!-- JavaCPP (1.5.14) -->
<dependency>
<groupId>org.bytedeco</groupId>
<artifactId>javacpp</artifactId>
<version>1.5.14</version>
</dependency>
</dependencies>PHP
PHP 8.2〜8.5（NTS ビルドのみ・スレッドセーフ(ZTS)版は非対応）。
ダウンロードページで OS と実行中の PHP バージョンに合うビルドを選択してください。
全 OS 共通: composer require の後に同梱インストーラ（vendor/bin/phposbxl-install）を1回実行すると ini 登録まで完了します。
# 1. 作業ディレクトリ作成・移動（~/phposbxl-test を作業ディレクトリと仮定）
mkdir ~/phposbxl-test && cd ~/phposbxl-test
# HPからダウンロードした適切なOS・PHPバージョンのzipを ~/phposbxl-test へ配置
# 2. composer zip の設定とインストール (artifact リポジトリ・展開不要)
composer config repositories.phposbxl artifact ~/phposbxl-test/
composer require osb-office/phposbxl
vendor/bin/phposbxl-install
macOS（-macosx_11_0_arm64.zip）および Windows（-win-x64.zip）もファイル名のみの違いで、手順は同一です。
インストーラは必要時に sudo へ自動昇格し、ini（scan dir または php.ini）へ登録します。FPM/Web サーバーは導入後再起動してください。
※ Windows 公式 NTS ランタイムで PATH が通っていない場合は、& "C:\php\php.exe" ... composer.phar のようにフルパスで実行してください。
※ artifact リポジトリには PHP の zip 拡張が必要です（Linux: sudo apt install php-zip、Windows: extension=php_zip.dll 等）。
Composer が未インストールの場合
# 公式 (https://getcomposer.org/) のインストーラで composer を導入して初期化
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php composer-setup.php --install-dir=/usr/local/bin --filename=composer
php -r "unlink('composer-setup.php');"
composer init --no-interactionアンインストール
vendor/bin/phposbxl-install --uninstall
ini 設定ファイル（zz-phposbxl.ini 等）への登録を解除します。
WebAssembly
Node 24 以上に対応しています。
npm install ./wasmosbxl-1.5.1.tgzブラウザ環境で単体スクリプトとして読み込む場合:
<!-- パッケージを展開して HTML に読み込む -->
<script src="osbxl_wasm.js"></script>評価版のご注意
ライセンスをアクティベーションするまでは評価版として動作します。
評価版では、各Excelスプレッドシートの先頭30行までしか追加・修正できません。
31行目以降への書き込みは制限されます（読み取りは可能です）。
本格的にご利用いただく場合は、ライセンスのアクティベーションが必要です。
3 ライセンスをアクティベーション
製品をご購入後、ライセンスファイルをメールにて送付しますので、ライセンス設定手順（要会員ログイン）を参考に設定してください。 全機能が無制限にご利用いただけます。
4 すぐに開発を始められます
アクティベーション前でも評価版としてすぐに開発・テストが可能です。
制限事項（先頭30行のみ編集可能）をご確認の上、まずは評価版でお試しいただけます。
本格的にご利用いただく際に、ライセンスのアクティベーションを行ってください。
const osbxl = require("osbxl");
const app = new osbxl.App();
const book = app.createWorkBook("/tmp/demo.xlsx");
const sheet = book.addWorkSheet("Sheet1");
sheet.getRange("A1").setNumberValue(100);
sheet.getRange("A2").setNumberValue(200);
sheet.getRange("A3").setFormula("SUM(A1:A2)");
const values = sheet.getRange("A3").getValue();
console.log(values["A3"]); // "300"
book.save();
book.close();AIアシスタント（Cursor / Copilot / Gemini / Claude）で開発を爆速化
手作業でコードを書く代わりに、公式AIスキルをプロジェクトに配置すれば、自然言語のプロンプトから高精度なコードを自動生成できます。