XPLATFORMの最新のバージョンは、既存のバージョンのアップデートが含まれます。この章では、最新のバージョンに新しく追加、変更された内容と、既存のバージョンのアップデート内容について説明します。

XPLATFORMV9.2.2バージョンにアップデートされて変更される項目は以下のとおりです。

• エンジンのCLSIDが変更されました。

• モジュールファイル名が変更されました。

• エンジンのインストールパスが変更されました。

バージョン情報

XPLATFORMエンジンのCLSIDが変更されました。

モジュール

ランチャーは、新しくインストールした上位バージョンが下位バージョンを置き換え、下位互換性を維持します。

各バージョンごとのモジュール間の依存関係と共有 DLLの参照のために、モジュール名が変更されました。

XPLauncher

• CLSIDはXPLATFORMV9.2.0バージョンと同じです。

• 下位互換性を維持します。

• 一部のメソッドの機能が変更されました。

  • launch()

  • getengineversion()

  • makeshortcut()

• 一部のプロパティが追加されました。

  • enginesetupkey

  • version

XPlatformAX

CLSIDとレジストリが変更されました。XPlatformAXで使用するCLSIDとレジストリはアップデートバージョンの変更時に変更されます。

npXLauncherPlugin

CLSIDはXPLATFORMV9.2.0バージョンと同じです。

• 下位互換性を維持します。

• 一部のメソッドの機能が変更されました。

  • launch()

  • getengineversion()

  • makeshortcut()

• 一部のプロパティが追加されました。

  • enginesetupkey

  • version

npXPlatformPlugin

CLSIDとレジストリが変更されました。npXPlatformPluginで使用するCLSIDとレジストリはアップデートバージョンの変更時に変更されます。

インストールパス

アップデートバージョンが変更されると、下位バージョンが独立に実行できるようにインストールパスが変更されます。

エンジンインストールパス

V9.2.2バージョンでエンジンのインストールパスは次のとおりです。

C:\Program Files\TOBESOFT\XPLATFORM\9.2.2\
C:\Program Files (x86)\TOBESOFT\XPLATFORM\9.2.2\

UX Studioインストールパス

V9.2.2バージョンでUX Studioのインストールパスは次のとおりです。

C:\Program Files\TOBESOFT\XPLATFORM\9.2.2\UXStudio92.exe
C:\Program Files (x86)\TOBESOFT\XPLATFORM\9.2.2\UXStudio92.exe

コンポーネントインストールパス

• コンポーネントのインストールパスは、既存のようにユーザーが指定した場所に設置することができます。

• インストールパスを指定しない場合には、デフォルト設定された場所にインストールします。

• 以前のバージョン(V9.2.0あるいはV9.2.1)と上位バージョン(V9.2.2)が衝突しないようにするには、別の場所を設定する必要があります。

ユーザーがインストールパスを指定しなかった場合、デフォルトでインストールされるパスは、次のとおりです。

C:\Users\[User name]\AppData\LocalLow\TOBESOFT\XPlatform\9.2\Component
C:\Users\[User name]\AppData\LocalLow\TOBESOFT\XPlatform\9.2.1\Component
C:\Users\[User name]\AppData\LocalLow\TOBESOFT\XPlatform\9.2.2\Component

XLauncher.xadl = Server_Path + "/Sample_PRJ/Sample_MDI.xadl";//プロジェクトのxadl場所
XLauncher.onlyone = true;//実行するプログラム１つor１つ以上実行するかどうか設定
XLauncher.splashimage = Server_Path+"/Install/img/loading_img.gif";//loading 画像指定部分
XLauncher.componentpath="%USERAPPLOCAL%/tobeComponent/9.2.2/componet/";

デスクトップのショートカットアイコン

• 既存に作られたデスクトップのショートカットアイコンをそのまま使用します。

• デスクトップのショートカットアイコンをインストールしていない場合には、新たにインストールします。

• デスクトップのショートカットアイコンが複数の場合には、名前が同じのものだけ変更します。

XPLauncherで makeshortcutメソッドを実行した場合、ショートカットの対象パスが次のように変更されます。

"C:\Program Files\TOBESOFT\XPLATFORM\9.2.2\XPlatform.exe"
    -K 'XFShowCase'
    -X 'http://localhost:8080/Next_JSP/XFShowcase/UI/ShowCase.xadl'

既存に作られたデスクトップのショートカットアイコンがある場合は、以下の条件に基づいて処理します。

• XPLauncher.enginesetupkeyプロパティ値とXPLauncher.versionプロパティ値を参照します。

• 両方の項目がすべて指定された場合には、enginesetupkeyプロパティ値を優先参照します。

• 両方の項目がすべて指定されていない場合には、9.2.0バージョンで動作します。

• 指定したXPLauncher.enginesetupkeyプロパティ値が9.2.1バージョンのCLSIDではなければ 9.2.0バージョンで動作します。

• 指定したXPLauncher.versionプロパティ値が9.2、9.2.1、9.2.2の以外の値であれば9.2.0バージョンで動作します。

xplatform.xml

XPLATFORM初期設定ファイルであるxplatform.xmlファイルは、次の場所にインストールされます。

C:\Users\[User name]\AppData\LocalLow\TOBESOFT\XPLATFORM\9.2\xplatform.xml
C:\Users\[User name]\AppData\LocalLow\TOBESOFT\XPLATFORM\9.2.1\xplatform.xml
C:\Users\[User name]\AppData\LocalLow\TOBESOFT\XPLATFORM\9.2.2\xplatform.xml

ログファイル

ログファイルは下記の場所に保存します。

C:\Users\[User name]\AppData\LocalLow\TOBESOFT\XPlatform\9.2\*.log
C:\Users\[User name]\AppData\LocalLow\TOBESOFT\XPlatform\9.2.1\*.log
C:\Users\[User name]\AppData\LocalLow\TOBESOFT\XPlatform\9.2.2\*.log

XADL

XADLプロパティが追加されました。

updateshortcut

エンジンでデスクトップのショートカットアイコン処理方法を指定します。

xadl.updateshortcut = "none/auto/updateurl"

updateurl

updateshortcutプロパティ値がupdateurlの場合、接続されるXLauncherがあるURLを指定します。

xadl.updateurl = url
xadl.updateurl = "http://www.xplatform.com/xplatform_update.html"

XLauncherがあるパスを指定します。 Webブラウザ(IE)を実行してXLauncherを介してデスクトップのショートカットアイコンを変更します。updateurlに指定されたurlをパラメータとしてエンジンがIEブラウザを実行します。

ランチャー(XPLauncher, npXLauncherPlugin)

9.2.1バージョンからランチャー関連の一部の機能が変更と追加されました。

• 一部のメソッドの機能が変更されました。

  • launch()

  • getengineversion()

  • makeshortcut()

• 一部のプロパティが追加されました。

  • enginesetupkey

  • version

launchメソッド

XPLATFORMアプリケーションを実行するメソッドです。

• key、xadl項目がないとアプリケーションを実行することができず、エラーとして処理します。

• xplatform.xmlファイルを読み書きする過程に問題が発生した場合、エラーとして処理します。

• エラーは error()イベントメソッドで確認することができます。

• launchメソッドで実行するXPLATFORMエンジンのバージョンを指定するには enginesetupkeyプロパティまたはversionプロパティを使用します。

  • 両方の項目がすべて指定されていない場合には、9.2.0バージョンのXPLATFORMが実行されます。

  • 指定されたenginesetupkeyプロパティ値が9.2.0バージョンのCLSIDではないと、9.2.0バージョンのXPLATFORMが実行されます。

  • 指定されたversionプロパティ値が9.2あるいは9.2.1、9.2.2以外の値であれば9.2.0バージョンのXPLATFORMが実行されます。

getengineversionメソッド

XPLATFORM ProductKey値に該当するエンジンのバージョンを取得するメソッドです。

• 引数として入力されたengine key値でレジストリに登録されたDisplayVersion情報を返します。

  ex) 9.2.2.153

• 引数として入力されたengine key値が存在しないか、入力されたengine keyとマッチングされたversion情報が見つからない場合は、すべてのインストール済みのバージョン情報を返します。インストールバージョンが複数の場合、カンマ(,)で各バージョンを区別します。

  ex) 9.2.0.153,9.2.2.150

makeshortcutメソッド

ショートカットアイコンを作成するメソッドです。

• 引数として入力されたアイコンのパスが遠隔地のサーバーである場合には、ファイルをダウンロードした後、指定されたcomponentpathに保存し、ショートカットアイコンのパスもcomponentpathで指定します。

• 引数として入力したショートカットアイコンの名前のようなアイコンが存在する場合は、アイコンを削除して再作成します。

• Windows 8 OSでは、次のような場合に管理者権限がないと、ショートカットアイコンのインストールが制限されることがあります。このような場合には、管理者権限でWebブラウザを起動してください。

  • bAllUserパラメータの値をtrueに設定した場合：公共desktopあるいは公共 startmenu

  • ショートカットインストール場所、あるいはアイコンファイルのダウンロードパスがシステムフォルダである場合

• ショートカットの実行対象となるXPLATFORMエンジンの実行パスとバージョンを指定するためにenginesetupkeyプロパティとversionプロパティを使用します。

• enginesetupkeyプロパティ値と versionプロパティ値をどのように指定するかによって、次のように処理されます。

  • enginesetupkeyプロパティ値と versionプロパティ値の両方を指定しない場合には、9.2.0バージョンで動作します。

  • enginesetupkeyプロパティ値のみ指定したまま versionプロパティ値を指定しない場合には、enginesetupkeyと一致するエンジンキー値のバージョンで動作し、それ以外はすべて9.2.0バージョンで動作します。

  • version プロパティ値を指定してenginesetupkeyプロパティ値を指定しない場合には、versionプロパティ値によってインストールパスが決定されます。(C:\Program Files\TOBESOFT\XPLATFORM\9.2 または9.2.2)

  • バージョンを特定して指定していない場合には、9.2.0バージョンで動作します。 XPLATFORMの特定のバージョンを動作する必要がある場合は、必ず versionプロパティ値を指定してください。

Enginesetupkeyプロパティ

特定のバージョンの XPLATFORM ProductKey値を指定するプロパティです。

• launch、makeshortcutメソッドの実行時に、特定のバージョンのXPLATFORMを指定しようとするときに参照される値です。

• enginesetupkeyプロパティ値を指定した状況に該当するXPLATFORMのインストールパスが見つからない場合、エラーとして処理します。

• enginesetupkeyプロパティ値とversionプロパティ値をどのように指定するかによって、次のように処理されます。

  • enginesetupkeyプロパティ値とversionプロパティ値の両方を指定しない場合には、9.2.0バージョンで動作します。

  • enginesetupkeyプロパティ値のみ指定したまま versionプロパティ値を指定しない場合には、enginesetupkeyと一致するエンジンキー値のバージョンで動作し、それ以外はすべて9.2.0バージョンで動作します。

  • version プロパティ値のみ指定したまま enginesetupkeyプロパティ値を指定しない場合には、versionプロパティ値によってインストールパスが決定されます。(C:\Program Files\TOBESOFT\XPLATFORM\9.2 または9.2.2など)

launcher.enginesetupkey = "{0239FCE5-88CF-48e9-912D-90DAFC25E38B}"; //9.2
launcher.enginesetupkey = "{AA890DB4-7357-4237-82BB-D0B931AAB420}"; //9.2.1
launcher.enginesetupkey = "{E05CD7D8-28AF-4577-89AC-E4F1F8ABF046}"; //9.2.2

Versionプロパティ

XPLATFORMの動作バージョンを指定するプロパティです。

• versionプロパティ値は、ランチャーのメソッド呼び出しの前に明示する必要があります。

• versionプロパティ値として指定できる値は9.2、9.2.1の2つです。別のディストリビューションを使用している場合でも、2つの値の中で実際のXPLATFORMバージョン値を入力します。

• versionプロパティ値を指定しない場合には、enginesetupkeyプロパティに各バージョンに合うエンジンキー値を指定した場合にのみ該当バージョンで動作し、それ以外はすべて9.2.0バージョンで動作します。

launcher.version = "9.2";
launcher.version = "9.2.1";
launcher.version = "9.2.2";

拡張モジュール

XPLATFORMベースモジュールに加えて拡張モジュールを使用している場合、該当モジュールのリビルドが必要になります。

ExtCommonApi

ExtCommonApiは、製品とは別のチップで提供する拡張モジュールです。技術サポート対象ではないが、アップデートバージョンに応じて変更されたモジュールを提供しています。

独自の拡張モジュール

プロジェクトの必要によって直接マッピングしたモジュールを使用した場合でも、SDKを利用したリビルドが必要になります。

ソースコードの互換性

以前のバージョン(9.2.0、9.21)のソースコードは、アップデートバージョン(9.2.2)で変更することなく使用することができます。

アップデートバージョンで生成するか保存したプロジェクトは、以前のバージョンで使用時にエラーが発生する可能性があります。アップデートバージョンに追加されたプロパティやメソッドを使用した場合、以前のバージョンでそれを認識できなくてエラーが発生し、必要な場合、開発者が直接変更する必要があります。

9.2.1バージョンで追加されたプロパティは下記のとおりです。以降のパッチバージョンやアップデートバージョンによって追加または変更されることがあります。

• デスクトップのショートカットアイコン作成関連プロパティ

• Application > updateshortcut, updateurl

• 国別RTLサポートプロパティ

• Application > rtldirection

• Binary Components > rtldirection, rtlimagemirroring