Android and iOS SDKs para desarrolladores de aplicaciones móviles

Puede desarrollar un widget que no necesite datos del usuario.

Pero en la mayoría de los casos, le convendrá obtener algo de entrada (p. ej., ingresada en los campos de texto o seleccionada en las listas desplegables) del usuario. Esta sección describe cómo escribir la configuración XML de su widget.

La versión actual de la estructura implementada es 0.1. Usted puede descargar una declaración de esquema XML de nuestro sitio.

En la versión 0.1 hay 6 elementos posibles de la estructura:

1. Elemento de bloque (utilizado para organizar elementos de tipos 2 a 6 en grupos lógicos)
2. Campo de texto
3. Campo del área de texto (entrada de texto multilínea)
4. Campo de la lista desplegable
5. Casilla de verificación
6. Botón de radio (utilizado en grupos de, al menos, dos botones de radio)

Información general

La configuración XML básica debe incluir la sección <fields /> (campos). Si no necesita información del usuario, simplemente cargue una configuración que solo contenga el código que se enumera a continuación. En este caso, un usuario final solo verá nuestra entrada de texto "Title" (Título) estándar, sin ningún elemento de entrada adicional (Fig. 6.1).

<?xml version="1.0" encoding="UTF-8"?>
<iba:fields iba:version="0.1" xmlns:iba="http://ibuildapp.com/userWidgets/0.1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://ibuildapp.com/userWidgets/0.1 http://ibuildapp.com/module_fields.xsd"/>

Fig. 6.1

Los datos que ingrese el usuario final se utilizarán para crear una configuración XML de los datos de la aplicación que se pasará a su widget desde nuestro lado.

Sin embargo, una estructura de campos vacíos se transformará en una estructura de datos vacíos:

<data>
</data>

Cada campo tiene, básicamente, 3 atributos:

• “name” (nombre) (cadena, requerido): Nombre de la etiqueta XML en la configuración “data” (datos) que contendrá los datos ingresados de este elemento
• “label” (etiqueta) (cadena, opcional): Etiqueta de texto que se presentará a la izquierda de un elemento de entrada en nuestro Panel de administración de aplicaciones
• “caption” (leyenda) (cadena, opcional): Etiqueta de texto que se presentará al lado de un elemento de entrada o debajo de este

Bloque

Los bloques se utilizan para organizar otros campos en grupos lógicos

La etiqueta de bloques tiene un atributo específico:

• state (estado) ("static" [Estático]/"on" [Activo]/"off" [Inactivo], opcional, predeterminado "static"): El estado de este bloque: "static" (Estático) significa que siempre estará presente, "on" [Activo]/"off" [Inactivo] significa que el usuario puede cambiar entre estos bloques; solo puede seleccionarse un bloque no estático en un momento

Los bloques difieren de todos los demás elementos en el modo en que estánpresentes en “data” (datos). No tienen una etiqueta especial (por lo tanto, no se utiliza el atributo “name” [Nombre]), pero se reemplazan con las etiquetas de todos los elementos secundarios.

Sin embargo, esto es cierto solo para los bloques "static" (Estático) y el bloque que esté actualmente "on" (Activo). Si el bloque está "off" (Inactivo): ni este ni sus bloques secundarios estarán presentes en data (Datos) XML.

Un bloque es una especie de elemento raíz (solo los bloques pueden estar dentro de un elemento de <“fields”/> [campos]), de modo que, si su widget necesita, al menos, un elemento de entrada, tendrá, al menos, un bloque.

Texto

<?xml version="1.0" encoding="UTF-8"?>
<iba:fields iba:version="0.1" xmlns:iba="http://ibuildapp.com/userWidgets/0.1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://ibuildapp.com/userWidgets/0.1 http://ibuildapp.com/module_fields.xsd">
	<iba:block iba:name="block1">
		<iba:text iba:name="textfieldA" iba:label="Textfield label:" iba:caption="Caption goes under the textfield"/>
	</iba:block>
</iba:fields>

Fig. 6.2

<data>
	<textfieldA></textfieldA>
</data>

Área de texto

El área de texto es exactamente igual que el texto, excepto que puede contener múltiples líneas de texto.

Lista desplegable

<?xml version="1.0" encoding="UTF-8"?>
<iba:fields iba:version="0.1" xmlns:iba="http://ibuildapp.com/userWidgets/0.1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://ibuildapp.com/userWidgets/0.1 http://ibuildapp.com/module_fields.xsd">
	<iba:block iba:name="block1">
		<iba:dropdown iba:name="myDropdown" iba:default="2" iba:label="Dropdown:" iba:caption=""option #2" is selected by default">
			<iba:option iba:value="">please select something</iba:option>
			<iba:option iba:value="1">the first option</iba:option>
			<iba:option iba:value="one more option">option #2</iba:option>
			<iba:option iba:value="the_last">the last one</iba:option>
		</iba:dropdown>
	</iba:block>
</iba:fields>

Fig. 6.3

Fig. 6.4

<data>
	<myDropdown>one more option</myDropdown>
</data>

Casilla de verificación

<?xml version="1.0" encoding="UTF-8"?>
<iba:fields iba:version="0.1" xmlns:iba="http://ibuildapp.com/userWidgets/0.1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://ibuildapp.com/userWidgets/0.1 http://ibuildapp.com/module_fields.xsd">
	<iba:block iba:name="block1" iba:label="Some block">
		<iba:checkbox iba:name="checkboxA" iba:label="1st checkbox" iba:checked="true"/>
		<iba:checkbox iba:name="checkboxB" iba:value="some value" iba:label="2nd checkbox" iba:caption="some descriptive caption"/>
	</iba:block>
</iba:fields>

Fig. 6.5

<data>
	<checkboxA></checkboxA>
</data>

Radio

<?xml version="1.0" encoding="UTF-8"?>
<iba:fields iba:version="0.1" xmlns:iba="http://ibuildapp.com/userWidgets/0.1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://ibuildapp.com/userWidgets/0.1 http://ibuildapp.com/module_fields.xsd">
	<iba:block iba:name="block1" iba:caption="Block's caption">
		<iba:radio iba:name="radiobutton1" iba:value="first" iba:label="Radio label:"/>
		<iba:radio iba:name="radiobutton1" iba:value="2nd" iba:caption="2nd radiobutton has caption"/>
		<iba:radio iba:name="radiobutton1" iba:value="the last one" iba:caption="3rd radiobutton is checked by default" iba:checked="true"/>
	</iba:block>
</iba:fields>

Fig. 6.6

<data>
	<radiobutton1>the last one</radiobutton1>
</data>

¡Más ejemplos!

Ejemplo 1

<?xml version="1.0" encoding="UTF-8"?>
<iba:fields iba:version="0.1" xmlns:iba="http://ibuildapp.com/userWidgets/0.1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://ibuildapp.com/userWidgets/0.1 http://ibuildapp.com/module_fields.xsd">
	<iba:block iba:name="b1" iba:caption="Ther are three static blocks">
		<iba:text iba:name="textField" iba:label="Textfield #1:">default text</iba:text>
		<iba:checkbox iba:name="cb1" iba:value="on" iba:checked="true" iba:caption="check me!"/>
	</iba:block>
	<iba:block iba:name="b2" iba:state="static">
		<iba:dropdown iba:name="dropdown" iba:default="0" iba:label="Dropdown field:">
			<iba:option iba:value=""/>
			<iba:option iba:value="a">letter "A"</iba:option>
			<iba:option iba:value="b">letter "B"</iba:option>
		</iba:dropdown>
		<iba:textarea iba:name="multilineText" iba:label="Textarea" iba:caption="Caption under textarea">Some text
It has two lines.</iba:textarea>
	</iba:block>
	<iba:block iba:name="b3">
		<iba:checkbox iba:name="cb2" iba:value="on" iba:caption="don't check me!"/>
		<iba:radio iba:name="radio" iba:value="1st" iba:label="Select one:" iba:caption="1st radio" iba:checked="true"/>
		<iba:radio iba:name="radio" iba:value="2nd" iba:caption="2nd radio"/>
	</iba:block>
</iba:fields>

Fig. 6.7

<data>
	<textField>default text</textField>
	<cb1>on</cb1>
	<dropdown></dropdown>
	<multilineText>Some text
It has two lines.</multilineText>
	<radio>1st</radio>
</data>

Ejemplo 2

<?xml version="1.0" encoding="UTF-8"?>
<iba:fields iba:version="0.1" xmlns:iba="http://ibuildapp.com/userWidgets/0.1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://ibuildapp.com/userWidgets/0.1 http://ibuildapp.com/module_fields.xsd">
	<iba:block iba:name="block1" iba:state="on" iba:label="One way:">
		<iba:text iba:name="text1" iba:label="Text 1:">Default for text #1</iba:text>
	</iba:block>
	<iba:block iba:name="block2" iba:state="off" iba:label="Another way:">
		<iba:text iba:name="text2" iba:label="Text 2:">Default for text #2</iba:text>
	</iba:block>
</iba:fields>

Fig. 6.8

<data>
	<text1>Default for text #1</text1>
</data>

Fig. 6.9

<data>
	<text2>Default for text #2</text2>
</data>

Ejemplo 3

<?xml version="1.0" encoding="UTF-8"?>
<iba:fields iba:version="0.1" xmlns:iba="http://ibuildapp.com/userWidgets/0.1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://ibuildapp.com/userWidgets/0.1 http://ibuildapp.com/module_fields.xsd">
	<iba:block iba:name="block1">
		<iba:checkbox iba:name="myCheckbox" iba:value="1" iba:checked="true" iba:label="Checkbox:"/>
	</iba:block>
	<iba:block iba:name="block2" iba:state="off" iba:caption="use text">
		<iba:text iba:name="myText" iba:label="Text field:">some default text</iba:text>
	</iba:block>
	<iba:block iba:name="block3" iba:state="on" iba:caption="use textarea">
		<iba:textarea iba:name="myTextarea" iba:label="Textarea field:">some default text in textarea</iba:textarea>
	</iba:block>
	<iba:block iba:name="block4">
		<iba:dropdown iba:name="myDropdown" iba:label="Dropdown">
			<iba:option iba:value="option0">Option 0</iba:option>
			<iba:option iba:value="option1">Option 1</iba:option>
			<iba:option iba:value="option2">Option 2</iba:option>
		</iba:dropdown>
	</iba:block>
</iba:fields>

Fig. 6.10

<data>
	<myCheckbox>1</myCheckbox>
	<myTextarea>some default text in textarea</myTextarea>
	<myDropdown>option0</myDropdown>
</data>