0.1.2

Author: bandit-ibayashi

CHANGELOG.md

@@ -1,7 +1,17 @@
 - [日本語](Documents/CHANGELOG_JP.md)  
 
 # Change Log  
+
+## 0.1.2(2026/01/21)  
+
+* Added StarPrinterFactory class  
+* Supported Windows  
+* Bug fixes  
+
+## 0.1.1(2025/12/04)  
+
+* Replaced license file  
 
 ## 0.1.0(2025/11/28)  
 
-  Beta version release  
+* Beta version release  

Documents/CHANGELOG_JP.md

@@ -1,7 +1,17 @@
 - [English](../CHANGELOG.md)  
 
 # 変更点  
+
+## 0.1.2(2026/01/21)  
+
+* StarPrinterFactoryクラス追加  
+* Windows対応  
+* バグ修正  
+
+## 0.1.1(2025/12/04)  
+
+* ライセンスファイル差し替え  
 
 ## 0.1.0(2025/11/28)  
 
-  ベータ版初版リリース  
+* ベータ版初版リリース  

Documents/Manual.md

@@ -1,4 +1,4 @@
-# StarXpand SDK for Web Developer's manual V0.1.0  
+# StarXpand SDK for Web Developer's manual V0.1.2  
 
 ## Overview  
 
@@ -8,12 +8,13 @@ StarXpand SDK for Web is a software development kit that includes sample codes a
 
 | OS       | Browser |  
 | -------- | -------- |  
+| Windows  | Chrome   |  
+| Windows  | Edge     |  
 | macOS    | Chrome   |  
 | ChromeOS | Chrome   |  
 | Ubuntu   | Chrome   |  
 | Android  | Chrome   |  
-  
-Windows OS will be supported at V1.0.0.  
+   
 Firefox, Safari are not supported because they do not support WebUSB API as of November, 2025.  
 
 ### Language  
@@ -33,12 +34,42 @@ Firefox, Safari are not supported because they do not support WebUSB API as of N
 - mPOP series  
 - TSP100IV series  
 - TSP100IV-SK series  
-  
+
+## About replacing USB drivers
+In Windows and Ubuntu, it is necessary to replace the USB driver by following the procedure below.
+
+## In Windows
+1. Turn on the printer and connect the printer and the host terminal with a USB cable.  
+
+  The USB port that can communicate with the device varies depending on the printer.
+  Please check the online manual or hardware manual of the printer you are using.
+
+2. Replace the printer driver.　　
+  Run `example/scripts_for_client/Windows/install.bat` with administrator privileges.
+  When you execute the driver replacement, USB printers cannot be used from other software.
+  When using the printer with other software, please restore the driver by following the procedure below.
+
+  1. Open Device Manager
+  2. Right-click the corresponding printer from "Universal Serial Bus Devices" and select "Update driver"
+  3. Select "Browse my computer for drivers"
+  4. Select "Let me pick from a list of available drivers on my computer"
+  5. Select "USB Printing Support" and click "Next"
+
+## In Ubuntu
+Just before using the printer, run the following script with administrator privileges:
+  `example/scripts_for_client/linux/onetime.sh`
+
+  When you execute the script, the previously installed printer driver will become unusable.
+  The effect of the script will be reverted by performing the following operations. When using the previously installed printer driver, please perform the following operations.
+  - Unplug and replug the printer's USB cable
+  - Restart the printer
+  - Restart ubuntu
+
 ## Functions  
 
 ### StarXpandCommandBuilder  
 
-Provides the same functionality as [the react-native version](https://star-m.jp/products/s_print/sdk/react-native-star-io10/manual/en/api-reference/star-xpand-command/index.html). However, [the way to specify image sources](https://star-m.jp/products/s_print/sdk/react-native-star-io10/manual/en/api-reference/star-xpand-command/printer/image-parameter/constructor.html#star-xpand-command-printer-image-parameter-constructor) differs:  
+Provides the same functionality as [the react-native version](https://star-m.jp/products/s_print/sdk/react-native-star-io10/manual/en/api-reference/star-xpand-command/index.html). However, [the way to specify image sources](https://star-m.jp/products/s_print/sdk/react-native-star-io10/manual/en/api-reference/star-xpand-command/printer/image-parameter/constructor.html) differs:  
 
 - Image source specification  
   - Base64-encoded content  
@@ -70,6 +101,8 @@ Delegate notified when a printer is discovered
 #### Methods  
 
 - `constructor(connectionSettings: StarConnectionSettings)`  
+  It may take time until printing is possible.  
+  Using the StarPrinterFactory class can perform part of the initialization process in advance.
 
 - `async open(options: OpenOptions = new OpenOptions()): Promise<void>`  
 
@@ -82,6 +115,15 @@ Delegate notified when a printer is discovered
 - `async getStatus(options: GetStatusOptions = new GetStatusOptions(),): Promise<StarPrinterStatus>`  
 
 - `async getInformation(options: GetInformationOptions = new GetInformationOptions()): Promise<StarPrinterInformation>`  
+
+### StarPrinterFactory class
+
+#### Methods
+- `constructor()`
+
+- `createStarPrinter(connectionSettings: StarConnectionSettings): StarPrinter`  
+  Using the constructor of the StarPrinter class may take time until printing is possible.  
+  This method can shorten the time until printing is possible.
 
 ### Options.OpenOptions class  
 
@@ -137,14 +179,6 @@ Delegate notified when a printer is discovered
 - `emulation: StarPrinterEmulation`  
 - `detail: StarPrinterInformationDetail`  
 
-#### Methods  
-  
-- `serialize(): string`  
-  Get a JSON-formatted string containing printer information  
-  
-- `static deserialize(jsonString: string): StarPrinterInformation`  
-  Create a StarPrinterInformation object from a JSON string  
-  
 ### StarPrinterStatus class  
 
 #### Properties  
@@ -155,15 +189,7 @@ Delegate notified when a printer is discovered
 - `paperEmpty: boolean`  
 - `paperNearEmpty: boolean`  
 - `detail: StarPrinterStatusDetail`  
-  
-#### Methods  
-  
-- `serialize(): string`  
-  Get a JSON-formatted string containing printer status  
-  
-- `static deserialize(jsonString: string): StarPrinterStatus`  
-  Create a StarPrinterStatus object from a JSON string  
-  
+
 ### StarIO10Logger class  
 
 Output logs to the console  

Documents/Manual_JP.md

@@ -1,4 +1,4 @@
-# StarXpand SDK for web マニュアル　V0.1.0  
+# StarXpand SDK for web マニュアル　V0.1.2  
 
 ## 概要  
 
@@ -8,12 +8,13 @@
 
 | OS       | ブラウザ |  
 | -------- | -------- |  
+| Windows  | Chrome   |  
+| Windows  | Edge     |  
 | macOS    | Chrome   |  
 | ChromeOS | Chrome   |  
 | Ubuntu   | Chrome   |  
 | Android  | Chrome   |  
-  
-Windowsは、V1.0.0で対応予定です  
+
 Firefox、Safariは、2025年11月現在、WebUSB APIをサポートしていないため、非対応です  
 
 ### 言語  
@@ -33,13 +34,53 @@ Firefox、Safariは、2025年11月現在、WebUSB APIをサポートしていな
 - mPOP  
 - TSP100IV  
 - TSP100IV-SK  
-  
+
+## USBドライバの差し替えについて  
+
+WindowsおよびUbuntuでは、以下の手順でUSBドライバを差し替える必要があります。
+
+## Windowsの場合
+
+1. プリンターの電源を入れ、プリンターと上位端末をUSBケーブルで接続します。  
+
+  デバイスと通信可能なUSBポートはプリンターによって異なります。
+  ご利用いただくプリンターのオンラインマニュアルまたはハードウェアマニュアルにてご確認ください。
+
+2. プリンターのドライバを差し替えます。　　
+  `example/scripts_for_client/Windows/install.bat` を、管理者権限で実行してください
+
+  ドライバの差し替えを実行すると、他のソフトウェアからはUSBプリンターを使用できなくなります。
+  プリンターを他のソフトウェアで使用する際は、以下の手順でドライバーを元に戻してください。
+
+  1. デバイスマネージャーを開く
+  2. 「ユニバーサル シリアル バス デバイス」から該当のプリンターを右クリックし、「ドライバーの更新」を選択する
+  3. 「コンピューターを参照してドライバーを検索」を選択する
+  4. 「コンピューター上の利用可能なドライバーの一覧から選択します」を選択する
+  5. 「USB 印刷サポート」を選択し、「次へ」をクリックする
+
+### Ubuntuの場合  
+
+1. プリンターの電源を入れ、プリンターと上位端末をUSBケーブルで接続します。  
+
+  デバイスと通信可能なUSBポートはプリンターによって異なります。
+  ご利用いただくプリンターのオンラインマニュアルまたはハードウェアマニュアルにてご確認ください。
+
+2. プリンターのドライバを差し替えます。  
+  `example/scripts_for_client/linux/onetime.sh` を、管理者権限で実行してください
+ 
+  プリンタードライバを差し替えると、従来のプリンタードライバは使用できなくなります。  
+  以下の操作を行うと、スクリプトの効果は元に戻ります。従来のプリンタードライバを使用する際は、以下の操作を実行して下さい。  
+  
+  - プリンターのUSBケーブルを抜き差しする  
+  - プリンターを再起動する  
+  - Ubuntuを再起動する  
+
 ## 機能  
 
 ### StarXpandCommandBuilder  
 
   [react-native版](https://star-m.jp/products/s_print/sdk/react-native-star-io10/manual/ja/api-reference/star-xpand-command/index.html)と同様の機能を提供します  
-  ただし、[画像ソースの指定方法](https://star-m.jp/products/s_print/sdk/react-native-star-io10/manual/ja/api-reference/star-xpand-command/printer/image-parameter/constructor.html#star-xpand-command-printer-image-parameter-constructor)が異なります  
+  ただし、[画像ソースの指定方法](https://star-m.jp/products/s_print/sdk/react-native-star-io10/manual/ja/api-reference/star-xpand-command/printer/image-parameter/constructor.html)が異なります  
 
   - 画像ソースの指定方法  
     - Base64エンコードされたコンテンツ  
@@ -72,6 +113,8 @@ Firefox、Safariは、2025年11月現在、WebUSB APIをサポートしていな
 #### メソッド  
 
 - `constructor(connectionSettings: StarConnectionSettings)`  
+　　印字可能になるまで、時間がかかる場合があります。  
+　　StarPrinterFactoryクラスを使用すると、初期化処理の一部を事前に実行できます。  
 
 - `async open(options: OpenOptions = new OpenOptions()): Promise<void>`  
 
@@ -84,6 +127,16 @@ Firefox、Safariは、2025年11月現在、WebUSB APIをサポートしていな
 - `async getStatus(options: GetStatusOptions = new GetStatusOptions(),): Promise<StarPrinterStatus>`  
 
 - `async getInformation(options: GetInformationOptions = new GetInformationOptions()): Promise<StarPrinterInformation>`  
+
+### StarPrinterFactoryクラス
+  
+#### メソッド
+
+- `constructor()`
+
+- `createStarPrinter(connectionSettings: StarConnectionSettings): StarPrinter`  
+  StarPrinterクラスのコンストラクタを使用すると、印字可能になるまで時間がかかる場合があります。  
+  本メソッドを使用すると、印字可能になるまでの時間を短縮できます。
 
 ### Options.OpenOptionsクラス  
 
@@ -137,15 +190,7 @@ Firefox、Safariは、2025年11月現在、WebUSB APIをサポートしていな
 
 - `model: StarPrinterModel`  
 - `emulation: StarPrinterEmulation`  
-- `detail: StarPrinterInformationDetail`  
-  
-#### メソッド  
-  
-- `serialize():string`  
-  プリンター情報を格納した、JSON形式の文字列を取得する  
-  
-- `static deserialize(jsonString:string):StarPrinterInformation`  
-  JSON形式の文字列から、StarPrinterInformationオブジェクトを生成する  
+- `detail: StarPrinterInformationDetail`   
 
 ### StarPrinterStatusクラス  
 
@@ -158,14 +203,6 @@ Firefox、Safariは、2025年11月現在、WebUSB APIをサポートしていな
 - `paperNearEmpty: boolean`  
 - `detail: StarPrinterStatusDetail`  
 
-#### メソッド  
-  
-- `serialize():string`  
-  プリンターステータスを格納した、JSON形式の文字列を取得する  
-  
-- `static deserialize(jsonString:string):StarPrinterStatus`  
-  JSON形式の文字列から、StarPrinterStatusオブジェクトを生成する  
-  
 ### StarIO10Loggerクラス  
 
 コンソールにログを出力する  

Documents/README_JP.md

@@ -32,17 +32,20 @@ StarXpand SDKのドキュメントは[こちら](Manual_JP.md)を参照くださ
 ## 動作環境  
 
 
-| OS       | ブラウザ |  
-| -------- | -------- |  
-| macOS    | Chrome   |  
-| ChromeOS | Chrome   |  
-| Ubuntu   | Chrome   |  
-| Android  | Chrome   |  
-  
-Windowsは、V1.0.0で対応予定です  
-Firefox、Safariは、2025年11月現在、WebUSB APIをサポートしていないため、非対応です  
+| OS       | ブラウザ |
+| -------- | -------- |
+| Windows  | Chrome   |
+| Windows  | Edge     |
+| macOS    | Chrome   |
+| ChromeOS | Chrome   |
+| Ubuntu   | Chrome   |
+| Android  | Chrome   |
+
 <a id="TestEnvironment"></a>SDK同梱のサンプルアプリをビルドして動作することを確認しています  
 
+Firefox、Safariは、2025年11月現在、WebUSB APIをサポートしていないため、非対応です  
+
+  
 ## 導入  
 
 ```  
@@ -68,9 +71,14 @@ StarXpand SDKにはプリンターと組み合わせて動作を確認できる[
     ```bash  
     npm start  
     ```  
-4. ブラウザで http://localhost:3000 にアクセスする  
+
+4. USBドライバの事前準備  
+
+[マニュアル](Manual_JP.md#usbドライバの差し替えについて)を参照し、USBドライバの差し替えを実施してください  
+
+5. ブラウザで http://localhost:3000 にアクセスする  
 
-5. 検索  
+6. 検索  
 
     1. ブラウザ画面上の`Discovery`ボタンを押下し、 http://localhost/discovery:3000 にアクセスする  
 
@@ -102,7 +110,7 @@ StarXpand SDKにはプリンターと組み合わせて動作を確認できる[
 
     7. `StarXpand SDK for Web`を押下し、 http://localhost:3000 に戻る  
 
-6. 印刷  
+7. 印刷  
 
     1. `Printing`ボタンを押下し、 http://localhost/printing:3000 にアクセスする  
 

LICENSE

@@ -84,15 +84,15 @@ You should be aware that we may change this Agreement at any time. In the event
 
 
 
-Ⅱ．Terms and Conditions for Developers (Addendum to the General Terms and Conditions)
+Ⅱ.Terms and Conditions for Developers (Addendum to the General Terms and Conditions)
 
 If you are Star Development partner and the Software contains STAR’s software developer’s tool kit (hereinafter referred to as “SDK“) or API, your use of the SDK and API is governed by the terms of this “Terms and Conditions for Developers” in addition to the I.General Terms and Conditions. In the event of any conflict between the terms of the I.General Terms and Conditions and this Terms and Conditions for Developers, the terms of this Terms and Conditions for Developers shall govern. You should carefully read the following terms and conditions before using the SDK and API provided by STAR.
 The following teams Shall have the following meanings:
 The “SDK” is defined as the downloadable package of libraries, applications, and documentation that you may use solely in connection with development and testing of your software application(hereinafter referred to as “Application”) to enable it to communicate with a Star Product or device, as provided herein (hereinafter referred to as the “Permitted Use”). 
 The “API” is defined as the Application Programing interface information, specifications and documentation provided as a download for your Permitted Use.
 
 1. LICENSE
-Star grants you a limited, non-exclusive, non-transferable license to use the SDK and API, including the human readable code of the SDK (hereinafter referred to as “Source Code”), subject to the terms and restrictions set forth in I.General Terms and Conditionsthis and Terms and Conditions for Developers.
+Star grants you a limited, non-exclusive, non-transferable license to use the SDK and API, including the human readable code of the SDK (hereinafter referred to as “Source Code”), subject to the terms and restrictions set forth in I.General Terms and Conditions and this Terms and Conditions for Developers.
 
 2.Use of Source Code 
 The SDK is licensed to be used on any personal computer or networked machines, provided that the SDK is used only in connection with the Permitted Use. You may use the Source Code internally to engage in the Permitted Use and you may use, modify or merge all or portions of the Source Code with your Application and distribute it only as part of your Application in object code form only. 
@@ -105,23 +105,12 @@ Privacy Policy for SDK: https://www.star-m.jp/prjump/000193.html
 To read our latest Software License Agreement, please visit the following URL.
 https://www.star-m.jp/wp-content/uploads/SoftwareLicenseAgreement_web.pdf
 
-Copyright (c) 2013-2021 Niels Lohmann
-Released under the MIT license
-https://opensource.org/licenses/mit-license.php
 
-Copyright (c) .NET Foundation and Contributors
+Copyright (c) Meta Platforms, Inc. and affiliates.
 Released under the MIT license
 https://opensource.org/licenses/mit-license.php
 
-Copyright (c) 2015-present, Facebook, Inc.
-Released under the MIT license
-https://opensource.org/licenses/mit-license.php
-
-Copyright (c) 2022 Iddan Aaronsohn
-Released under the MIT license
-https://opensource.org/licenses/mit-license.php
 
-Copyright (c) 2015 Kyle Corbitt
-Copyright (c) 2020 Sayem Chowdhury
+Copyright (c) 2013-2022 Niels Lohmann
 Released under the MIT license
 https://opensource.org/licenses/mit-license.php