أدوات تطوير برامج الأندرويد وآي أو إس لمطوري التطبيقات المحمولة

يمكن أن تقوم بتطويرها ميزة التي سوف تحتاج إلى لا بيانات من المستخدم النهائي.

ولكن في معظم الحالات ستحتاج إلى الحصول على بعض المدخلات (مثل المدخلات في حقول النص أو المحددة في القوائم المنسدلة) من المستخدم. ويصف هذا القسم كيفية التكوين XML الخاص بالميزة.

الإصدار الحالي للهيكل المُنفذ هو 0.1. يمكنك تحميل تعريف "XML-Schema" من موقعنا.

يوجد في إصدار 0.1 6 ستة عناصر هيكل ممكنة:

1. عنصر البلوك (Block) (يستخدم لتنظيم العناصر من أنواع 2-6 في مجموعات منطقية)
2. حقل النص
3. حقل مربع النص (إدخال النص متعدد الأسطر)
4. حقل منسدل
5. مربع الاختيار
6. زر الاختيار "Radiobutton" (يستخدم في مجموعات من زرين اختيار على الأقل)

معلومات عامة

يجب أن يتضمن تكوين XML الأساسي قسم <fields />. إذا كنت لا تحتاج إلى أي معلومات من المستخدم - قم ببساطة برفع تكوين يحتوي فقط على التعليمات البرمجية المسرودة أدناه. وفي هذه الحالة سيرى المستخدم النهائي فقط مدخل نص "العنوان" القياسي، دون أي عناصر إدخال إضافية (الشكل 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"/>

شكل. 6.1

ستظهر حينها البيانات التي يدخلها المستخدم النهائي لإنشاء تكوين الـXML لبيانات التطبيق والتي سيتم تمريرها إلى الميزة الخاصة بك من جانبنا.

ومع ذلك سيتحول هيكل الحقول الفارغة إلى هيكل بيانات فارغ:

<data>
</data>

لدى كل حقل ثلاث صفات أساسية:

• name (سلسلة، مطلوب) - اسم علامة الـXML في تكوين data والذي يحتوي على البيانات المدخلة من هذا العنصر
• label (سلسلة، اختياري) - تسمية النص والتي ستكون على يسار عنصر الإدخال في لوحة إدارة التطبيقات الخاصة بنا
• caption (سلسلة، اختياري) - تسمية النص التي ستكون بجوار/تحت عنصر الإدخال

البلوك

تستخدم البلوكات في تنظيم الحقول الأخرى في مجموعات منطقية

لدى علامة البلوك صفة واحدة محددة:

• state ("ثابت" / "مفتوح" / "مغلق"، اختياري، الافتراضي "ثابت") - حالة هذا البلوك: "ثابت" يعني أنه سيكون حاضرا دائما، "مفتوح" / "مغلق" يعني أنه يمكن للمستخدم التبديل بين البلوكات. يمكن تحديد بلوك واحد غير ثابت فقط في نفس اللحظة

تختلف البلوكات عن جميع العناصر الأخرى في طريقة عرضهم في data فليس لديهم أي علامة خاصة (لذلك لا يتم استخدام name)، ولكن يتم استبدالها بجميع علامات عناصر التابعة.

ولكن، ينطبق هذا فقط على البلوكات "الثابتة" وهو البلوكات "المفتوحة" حاليا. إذا كان البلوك "مغلق" - فلن يتم عرضه ولا توابعه في كود الـXML data.

والبلوك هو عبارة نوع من أنواع العناصر الجذرية (يمكن للبلوكات أن تكون داخل عنصر فقط)، لذلك إذا كانت الميزة تحتاج لعنصر إدخال واحد على الأقل - سيكون لديك بلوك واحد على الأقل.

النص

<?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>

شكل. 6.2

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

مربع النص

مربع النص هو نفس النص إلا أنه يمكن أن يحتوي على عدة أسطر من النص.

قائمة منسدلة

<?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>

شكل. 6.3

شكل. 6.4

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

مربع الاختيار

<?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>

شكل. 6.5

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

زر الاختيار

<?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>

شكل. 6.6

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

المزيد من الأمثلة

مثال 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>

شكل. 6.7

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

مثال 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>

شكل. 6.8

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

شكل. 6.9

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

مثال 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>

شكل. 6.10

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