Kanzi 3.9.2 マイグレーションガイド¶

このマイグレーションガイドを使用して、Kanzi アプリケーションを Kanzi 3.9.1 から Kanzi 3.9.2 に更新してください。

Java 8¶

Kanzi Android framework (droidfw) と Kanzi Java API は、Java 8 (1.8) 以上が必要になりました。

アプリケーションのGradleファイルで、Java言語のバージョンが互換性のあるバージョンに設定されていることを確認してください。例えば、app/build.gradle で次のように設定します:

android {
    ...

    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
}

Kanzi Java API の変更¶

Metaclass のコンストラクタオーバーロードを削除しました。これにより、関連クラスを引数として渡す必要がなくなりました。Kanzi は、Metaclass インスタンスの初期化場所に基づいてクラスを自動的に推測します。

Metaclass の初期化を変更します
```
class MyClassName
{
   public static final Metaclass metaclass =
      new Metaclass("Example.MyClassName", MyClassName.class);
```
終点
```
class MyClassName
{
   public static final Metaclass metaclass =
      new Metaclass("Example.MyClassName");
```
Optional* ファミリーのクラスは使用されなくなり、削除されました。
- Matrix4x4.getRotationAngle() は、OptionalVector3 の代わりに、nullable な Vector3 を返すようになりました。
- Matrix4x4.createLookAtMatrix() は、OptionalMatrix4x4 の代わりに、nullable な Matrix4x4 を返すようになりました。

フォーカス処理の変更¶

Kanzi 3.9.2 では、フォーカス処理 API に次の変更が導入されました。

Kanzi 3.9.1	Kanzi 3.9.2
`Node::ContainsFocusProperty`	`Node::FocusStateProperty`
`ModalScope` はモーダルスコープを実装し、`PopupScope` に継承されます。	`OverlayScope` はオーバーレイタイプのフォーカススコープの基礎を実装し、以下によって継承されます: `AutoClosingModalScope` （`PopupScope` を置き換えます） `AutoClosingModelessScope` `ModalScope` `ModelessScope`
`FocusManager::FocusScopeType` 列挙子には次の値があります。 `NoScope` `Group` `Fence` `Modal` `Popup`	`FocusScopeType` 列挙子には次の値があります。 `NoScope` `Group` `Fence` `Modal` `AutoClosingModal` `Modeless` `AutoClosingModeless`
`FocusScope::getModalScope()`	`FocusScope::getOverlayScope()`
`getPopupTypeScopeForNode()`	`findOverlayScopeForNode()`
`isPopupTypeScope()`	`isOverlayScope()`
`FocusManager::createFocusScopeInfo()`	`FocusScope::create()` は、引数として `Node` または `FocusScopeType` と `Node` を取るバリアントを持ちます。
`void Node::updateFocusScopeInfo()`	`virtual void Node::updateFocusScopeInfo(FocusScopePtr& nodeScopeInfo)`
`FocusManager::getPrecedingScope()`、`ModalScope` を返します。	`FocusManager::getOverlayBelow()`、`OverlayScope` を返します。
`FocusManager::getForemostScope()`、`ModalScope` を返します。	`FocusManager::getForemostOverlay()`、`OverlayScope` を返します。
`FocusManager::getForemostScopeNode()`	`FocusManager::getForemostOverlayNode()`
`FocusManager::ScopeBroughtToFrontMessage`	`FocusManager::OverlayBroughtToFrontMessage`
`FocusManager::` `ScopeBroughtToFrontMessageArguments`	`FocusManager::` `OverlayBroughtToFrontMessageArguments`
`FocusManager::ScopeSentToBackMessage`	`FocusManager::OverlaySentToBackMessage`
`FocusManager::ScopeSentToBackMessageArguments`	`FocusManager::OverlaySentToBackMessageArguments`
`FocusManager::bringScopeToFront()`	削除されました
`FocusManager::BringScopeToFrontMessage`	削除されました
`FocusManager::BringScopeToFrontMessageArguments`	削除されました
`FocusManager::sendScopeToBack()`	削除されました
`FocusManager::SendScopeToBackMessage`	削除されました
`FocusManager::SendScopeToBackMessageArguments`	削除されました
`FocusManager::ScopeStack::bringToFront()`	削除されました
`FocusManager::ScopeStack::sendToBack()`	削除されました
`FocusManager::trySetFocus(ModalScope& popupScope, NodeSharedPtr newFocusNode)`	削除されました
`FocusManager::FocusChainDirection` 列挙子には次の値があります。 `PreviousFocusable` `NextFocusable`	`FocusChainDirection` 列挙子には次の値があります。 `Previous` `Next`
`FocusManager::FocusReason` 列挙子には次の値があります。 `ForceFocusReason` `FocusChainNavigationReason` `HiddenFocusReason` `UnhiddenFocusReason` `OtherScopeInFront` `ScopeDetached` `ScopeNextInStack` `OtherFocusReason`	`FocusReason` 列挙子には次の値があります。 `Force` `FocusChainNavigation` `Hidden`
`FocusManager::ScopeStack`	`detail::OverlayStack`

Kanzi の以前のバージョンで作成し、ポップアップタイプのフォーカススコープを含む Kanzi Studio プロジェクトを Kanzi 3.9.2 に移行するには、

Bring Scope To Front と Send Scope To Back アクションは存在しなくなりました。無効なアクションを、フォーカススコープの可視性を設定する Set Property アクションに置き換えてください。
オーバーレイの外側でタッチ出力を使用してオーバーレイを閉じるには、Input Outside Overlay トリガーとオーバーレイを非表示にする Set Property アクションを使用します。

オーバーレイを作成するを参照してください。

Kanzi 3.9.1で作成し、Contains Focus プロパティを使用している Kanzi Studio プロジェクトを Kanzi 3.9.2に移行するには、Focus State プロパティを使用してください。ユーザーインターフェース要素にフォーカスがあることを表示するを参照してください。

クラスメタデータの変更¶

クラス InputManipulator::InputMessageArguments 内のこれらのプロパティの名前を変更しました:

Kanzi 3.9.1	Kanzi 3.9.2
`InputMessageArguments.Manipulator.Point`	`InputManipulator.InputMessageArguments.ManipulatorPoint`
`InputMessageArguments.Manipulator.RayOrigin`	`InputManipulator.InputMessageArguments.ManipulatorRayOrigin`
`InputMessageArguments.Manipulator.RayDirection`	`InputManipulator.InputMessageArguments.ManipulatorRayDirection`
`InputMessageArguments.HitTest.Point`	`InputManipulator.InputMessageArguments.HitTestPoint`
`InputMessageArguments.HitTest.RayOrigin`	`InputManipulator.InputMessageArguments.HitTestRayOrigin`
`InputMessageArguments.HitTest.RayDirection`	`InputManipulator.InputMessageArguments.HitTestRayDirection`
`InputMessageArguments.HitTest.Object`	`InputManipulator.InputMessageArguments.HitTestObject`

StateManager でこれらのMessageArgumentメタクラスの名前を変更しました。

Kanzi 3.9.1	Kanzi 3.9.2
`Message.StateManager.MessageArguments`	`Message.StateManagerMessageArguments`
`Message.StateManagerStateChange.MessageArguments`	`Message.StateManagerStateChangeMessageArguments`
`Message.StateManagerGoToState.MessageArguments`	`Message.StateManagerGoToStateMessageArguments`
`Message.StateManagerGoToDefinedState.MessageArguments`	`Message.StateManagerGoToDefinedStateMessageArguments`
`Message.StateManagerGoToNextDefinedState.MessageArguments`	`Message.StateManagerGoToNextDefinedStateMessageArguments`
`Message.StateManagerGoToPreviousDefinedState.MessageArguments`	`Message.StateManagerGoToPreviousDefinedStateMessageArguments`
`Message.StateManagerEnteredState.MessageArguments`	`Message.StateManagerEnteredStateMessageArguments`
`Message.StateManagerLeftState.MessageArguments`	`Message.StateManagerLeftStateMessageArguments`
`Message.StateManagerTransition.MessageArguments`	`Message.StateManagerTransitionMessageArguments`
`Message.StateManagerTransitionStarted.MessageArguments`	`Message.StateManagerTransitionStartedMessageArguments`
`Message.StateManagerTransitionFinished.MessageArguments`	`Message.StateManagerTransitionFinishedMessageArguments`

Kanzi 3.9.2 マイグレーションガイド¶

Java 8¶

Kanzi Java API の変更¶

フォーカス処理の変更¶

クラスメタデータの変更¶

関連項目¶