ADF Mobileデバイス・リポジトリに新規デバイスを手動で追加できます。
10.1.3のデバイス・リポジトリに新規デバイスを追加する手順は、次のとおりです。
JDeveloper構成を誤って壊したりファイルを上書きすることのないように、<JDEV_HOME>/wireless/lib
にナビゲートし、deviceRepository.jar
ファイルを<WORK_DIR>
にJAR解除します。
注意: <WORK_DIR>
は、D:¥work_dir
など、なるべく<JDEV_HOME>
ディレクトリの外部の場所にしてください。
<WORK_DIR>oracle/wireless/device/capability/agent
にナビゲートし、capabilities.xml
ファイルを開きます。
<agentCapabilities>
ノードの下に、次のように新規ノードを追加します。
<capabilities id="device-name" agents="agent_name" platforms="platform_name">
<agentType>
<li value="agent_type"/>
</agentType>
<include refid="ref to some other device or agent by id"/>
<include src="device xml"/>
</capabilities>
capabilities.xsd
に基づいてデバイス固有のXMLを作成します。これを簡単に行うには、ディレクトリ内の既存のデバイスXML(capabilities.xml
以外)をコピーし、必要に応じて属性値を変更します。属性が不要な場合は削除可能であり、コピーしたXMLファイルに含まれない新規属性が必要な場合は、capabilities.xsd
で、追加できる属性のタイプの有無を確認します。
ステップ4で作成したデバイス固有のXMLファイルに、<id>.xml
という名前を付けます。ここで、<id>
は、ステップ3で追加した<capabilities>
ノードのid
属性の値と同じである必要があります。たとえば、HP-Jornada.xml
の場合、HP-Jornada
はid
属性の値です。
デバイスXMLファイルを <WORK_DIR>/oracle/wireless/device/capability/agent
にコピーします。
ファイルをJAR形式にし、deviceRepository.jar
を再作成します。このためには、<WORK_DIR>
からjar -cvf deviceRepository.jar .
コマンドを実行します。末尾に空白に続く.
があることに注意してください。これは、現在の作業ディレクトリを示します。
<JDEV_HOME>/wireless/lib
にある以前のdeviceRepository.jar
を、再作成したファイルと置き換えます。
注意: 新規ファイルと置き換える前に、元の deviceRepository.jar
のバックアップをとってください。プロセス全体でエラーが発生した場合に、元のファイルに戻すことができます。
ユーザー・エージェント文字列照合に基づいて属性を検索する際に、エージェント名およびプラットフォーム名も新しい場合は、この新規デバイスについて予期した結果が得られない可能性があります。デバイス属性にアクセスするには、ユーザー・エージェント文字列のかわりにデバイスIDを使用する必要があります。
次のコールを実行するテスト・コードを使用して、デバイスの追加を確認できます。
<capabilitiesProvider instance>.getCapabilities(<id attribute of the capabilities node>);
.
注意: すべて順調に進むと、新規に追加されたデバイスの機能が戻されます。
属性 | 値 | 説明 |
---|---|---|
|
device-name
|
この属性は必須です。値はなるべく英数字とし、ハイフン(-)が含まれる必要があります。リポジトリ内のデバイスを一意に識別する際に使用されます。 |
agents
|
agent_name
|
この属性はオプションです。値は必ずName/Version書式とし、空白で区切る必要があります。エージェントとその名前、さらにデバイスでサポートされるバージョンがリスト表示されます。 |
platforms
|
platform_name
|
この属性はオプションです。値は必ずName/Version書式とし、空白で区切る必要があります。デバイスのソフトウェア・プラットフォームについて説明します。 |
agentType
|
agent_type
|
この属性はオプションであり、値は任意のエージェント・タイプを指定できます。現在サポートされているエージェント・タイプは、デスクトップ、PDAおよびTelnetのみです。 |
|
IDによる他のデバイスまたはエージェントへの参照 | この属性はオプションであり、現在のデバイスにそのデバイスまたはエージェントの機能が含まれる場合、値は他のデバイスまたはエージェントの既存のIDを参照する必要があります。 |
src
|
デバイスXMLファイル |
この属性は必須であり、値は現在の
|
Name
の値は、連続する英数字の文字列となります。任意の文字数を意味する*
をワイルドカード文字として使用できますが、文字列の末尾のみとします。
Version
の値は数字とし、オプションで最後の文字として*
または+
を使用します。また、Version
の値自体はオプションです。
たとえば、<capabilities id="mypc" agents="NetFront/3+ Mozilla/6* Mozilla*">
となります。
<capabilities id="HP-Jornada" agents="ie/4+" platforms="ppc">
<agentType>
<li value="PDA"/>
</agentType>
<include refid="pocketie"/>
<include src="HP_Jornada.xml"/>
</capabilities>
CapabilitiesProvider cp = CapabilitiesProvider.getCapabilitiesProvider();
cp.getCapabilities("HP_Jornada")
デバイス機能へのアクセス
ADF Mobileデバイス・リポジトリのAPIリファレンス
Copyright © 1997, 2007, Oracle. All rights reserved.