自定义Android控件

为了实现自定义控件你需要本地构建。

为了创建Tabris.js自定义控件，我们使用Cordova的构建系统。因此，我们创建一个与Tabris.js特定的API相关联的Cordova插件。Tabris.js自定义控件不需要接触任何Cordova特定的Java API。通过Tabris.js特定的API可以实现与JavaScript部分的所有交互。

通过Cordova的插件架构，我们可以利用Cordova构建工具链，并在我们的插件中提供一个来自定义构建过程。一旦定义了一个插件，app就可以通过常规的cordova plugin add <plugin-id/git-url>shell命令或一个config.xml中的<plugin />来使用。

">一个本文档中概述的概念的使用示例可以在。找到。

自定义控件需要处理JavaScript传入的消息并将消息返回给JavaScript。此通信循环的主要入口点是com.eclipsesource.tabris.android.Operator。该Operator提供从JavaScript到原生平台的所有通信的回调方法。以下代码片段展示了一个使用com.eclipsesource.tabris.android.AbstractViewOperator作为View特定操作基础的基本操作：

上面的代码片段展示了Operator的两个重要方面：该类必须有一个具有两个参数的构造函数CalendarOperator(<Activity>, <TabrisContext>)，以及getType()方法必须返回JavaScript端自定义控件的名字。

Registering an operator

To make an operator available to the Tabris.js Android runtime we have to register it. The simplest way is to declare our operator in a meta-data entry of the AndroidManifest.xml.

        xmlns:android="http://schemas.android.com/apk/res/android"
        id="com.example.tabris.calendar">
  <platform name="android">
    <config-file target="AndroidManifest.xml" parent="/manifest/application">
      <meta-data
        android:name="com.example.tabris.android.OPERATOR.com.example.tabris.calendar"
    </config-file>
  </platform>
</plugin>

The snippet above inserts the meta-data element with its two attributes name and value into the AndroidManifest.xml. The name attribute has to be an application wide unique ID with a prefix of com.eclipsesource.tabris.android.OPERATOR. In order to make the name unique we append the widget specific ID .com.eclipsesource.tabris.calendar to the prefix. The value attribute of the meta-data element has to contain the fully qualified class name of our Operator implementation, eg.: com.eclipsesource.tabris.calendar.CalendarOperator.

With the Operator registered we can now instantiate the Android View object that we want to display in the UI. To handle a create operation sent from JavaScript we implement the Operator.create(<Properties>) method in the operator:

The snippet instantiates the Android android.widget.CalendarView with the Activity passed into the constructor of the Operator. The properties argument could contain widget specific configuration directives but is not used in this example.

Handling properties

While we have instantiated our widget and passed it back to the system, it is not yet visible in the UI. To show an Android View it has to be added to the view hierarchy. In order to do that we have to process the parent property passed in from JavaScript. The parent provides the widget onto which we want to add our custom widget.

Since this is a very common scenario we don’t have to implement this ourselves but rather rely on the pre-existing com.eclipsesource.tabris.android.ViewPropertyHandler. The ViewPropertyHandler implements the PropertyHandler interface which provides get and set methods to support various properties.

The concrete ViewPropertyHandler provides default implementations for like , layoutData, visible etc..

To activate the property handler we override AbstractOperator.getPropertyHandler() and return the corresponding handler:

@Override
public PropertyHandler<CalendarView> getPropertyHandler(CalendarView calendarView) {
}

Note how the snippet not only processes incoming properties in the set method but also provides a get implementation so that the date property can be read as well.

"> This API is likely going to change.

While receiving an operation from JavaScript covers a lot of ground we also want to send messages proactively to JavaScript. A classic example is a user initiated action like a button tap.

To send a message for a particular widget we use a com.eclipsesource.tabris.android.RemoteObject. A RemoteObject can be obtained from the TabrisContext via the ObjectRegistry:

RemoteObject remoteObject = tabrisContext.getObjectRegistry().getRemoteObjectForObject(view);

Continuing the example from above the following snippet sends a notify operation to JavaScript when the user changes the date on the CalendarView:

Destroying a widget

When a widget is no longer being used we also need to take care of destroying it. In case of our custom Android View we receive a destroy operation in the Operator and are responsible for cleaning up any resources that are not required anymore. When an Operator inherits from the AbstractViewOperator the destroy operation will remove the view from the view hierarchy.

@Override
public void destroy(CalendarView calendarView) {
  super.destroy(calendarView);
  // perform any necessary cleanup
}

原文: