Skip to content

Latest commit

 

History

History
332 lines (252 loc) · 12.2 KB

README.md

File metadata and controls

332 lines (252 loc) · 12.2 KB
Raw

Native Dialogs - Adobe air Native Extension

###Update: MUCH CHANGES IN THIS UPDATE - remove unnecessary events, IOS List Dialogs ###

Checked iOS 5.1 / android 2.3/3.1

See more info here

See compiled demo APK on You're android device

This extension enables showing native dialogs within a Air based project.

Available themes for android:

  • ANDROID_DEVICE_DEFAULT_DARK_THEME
  • ANDROID_DEVICE_DEFAULT_LIGHT_THEME
  • ANDROID_HOLO_DARK_THEME
  • ANDROID_HOLO_LIGHT_THEME
  • DEFAULT_THEME

NativeAlert (IOS/Android/Windows)

Android and iOS: Displays a native alert dialog.

iOS only: setting the badge of the app

Usage (badge):

if(NativeAlert.isBadgeSupported())
	NativeAlert.badge = 4;

Usage:

NativeAlert.defaultTheme = NativeAlert.ANDROID_DEVICE_DEFAULT_DARK_THEME;// not necessary
if(NativeAlert.isSuported)
NativeAlert.show( "some message" , "title" , "first button label" , "otherButtons,LabelsSeperated,WithAComma" , someAnswerFunction);

NativeAlert.dispose(); //only when exiting app
private function someAnswerFunction(event:NativeDialogEvent):void{
	trace(event.index);
}

NativeProgress (Android / IOS)

Android and iOS: The ability to display the native dialog showing a progress bar or a spinner.

NativeProgress for IOS by memeller

Available themes for IOS:

  • IOS_SVHUD_BLACK_BACKGROUND_THEME - uses SVProgressHUD
  • IOS_SVHUD_NON_BACKGROUND_THEME - uses SVProgressHUD
  • IOS_SVHUD_GRADIENT_BACKGROUND_THEME - uses SVProgressHUD
  • DEFAULT_THEME (cancleble is ignored)

iOS only: The ability to show and hide the native status-bar networki busy indicator.

if(NativeProgress.isNetworkActivityIndicatorAvalieble())
	NativeProgress.showNetworkActivityIndicator(true);

Usage:

private var progressPopup:NativeProgress;
private var p:int = 0;
private var myTimer:Timer = new Timer(100);
protected function openProgressPopup(style:int):void
{
		progressPopup = new NativeProgress(style);
	progressPopup.setSecondaryProgress(45);
	progressPopup.addEventListener(NativeDialogEvent.CANCELED,closeNativeProcessHandler);
	progressPopup.addEventListener(NativeDialogEvent.OPENED,traceEvent);
	progressPopup.addEventListener(NativeDialogEvent.CLOSED,closeNativeProcessHandler);
	progressPopup.addEventListener(ErrorEvent.ERROR,onError);// changed from NativeExtensionErrorEvent
	progressPopup.theme = ThemeSelector.selectedItem.data;
	progressPopup.setMax(50);
	progressPopup.setTitle(titleInput.text);
	progressPopup.setMessage(messageInput.text);
	progressPopup.show(canclebleCheckbox.selected,indeterminateInput.selected);
	myTimer.addEventListener(TimerEvent.TIMER, updateProgress);
	myTimer.start();
}

private function closeNativeProcessHandler(event:Event):void
{
 		progressPopup.removeEventListener(NativeDialogEvent.CANCELED,closeNativeProcessHandler);
 		progressPopup.removeEventListener(NativeDialogEvent.CLOSED,closeNativeProcessHandler);
 		progressPopup.removeEventListener(ErrorEvent.ERROR,onError);// changed from NativeExtensionErrorEvent
 		progressPopup.removeEventListener(NativeDialogEvent.OPENED,traceEvent);

	progressPopup.dispose();//before kill()
 		myTimer.removeEventListener(TimerEvent.TIMER,updateProgress);
 		myTimer.stop();
		p = 0;
}
private function updateProgress(event:TimerEvent):void
{
		p++;
		if(p>=50){
			p = 0;
			progressPopup.hide();
		(event.target as Timer).stop();
		}else
		progressPopup.setProgress(p);
	}

protected function viewBackKeyPressedHandler(event:FlexEvent):void
{
		event.preventDefault();
 		myTimer.removeEventListener(TimerEvent.TIMER,updateProgress);
 		myTimer.stop();
 		p = 0;
 		if(progressPopup){
    		progressPopup.hide("some message");
 		}
}

NativeApplication.nativeApplication.addEventListener(Event.EXITING,exiting);

protected function exiting(event:Event):void
{
		if(progressPopup)
    		progressPopup.dispose();//before kill()
}

NativeListDialog(Android / IOS)

IOS uses: SBTableAlert

NativeListDialog has the ability to show a native android popup dialog with a multi-choice or single-choice inside a Adobe Air project.

Usage:

private var multChDialog:NativeListDialog;
private var choces:Vector.<String>;
private var buttons:Vector.<String>;
private var checkedItems:Vector.<Boolean>;
private var selectedIndex:int = -1;

protected function view1_viewActivateHandler(event:ViewNavigatorEvent):void
{
	choces = new Vector.<String>();
	//the text of the items to be displayed in the list.
  		choces.push("one","two","three","four");
  		checkedItems = new Vector.<Boolean>();  
	// specifies which items are checked. It should be null in which case no items are checked. If non null it must be exactly the same length as the array of items.
  		checkedItems.push(true,false,false,true);
  		buttons = new Vector.<String>();
	//the labels for the buttons. It should be null in which case there will be only one button "OK". If non null max length 3 buttons
  		buttons.push("OK","Settings","Cancle");
}
protected function openMultiChoiceDialog(event:MouseEvent):void
{
	multChDialog = new NativeListDialog();
		multChDialog.theme = NativeListDialog.ANDROID_DEVICE_DEFAULT_LIGHT_THEME;
		
  		multChDialog.addEventListener(NativeDialogEvent.CANCELED,closeNativeDialogHandler);
  		multChDialog.addEventListener(NativeDialogEvent.OPENED,traceEvent);
  		multChDialog.addEventListener(NativeDialogEvent.CLOSED,closeNativeDialogHandler);
  		multChDialog.addEventListener(ErrorEvent.ERROR,onError);// changed from NativeExtensionErrorEvent
 		multChDialog.addEventListener(NativeDialogListEvent.LIST_CHANGE,onListChange);
 		
  		multChDialog.setTitle(titleInput.text); // before title ="Some Title"; - can change while in popup
  		multChDialog.setCancelable(canclebleCheckbox.selected);// before cancleble = true;- can change while in popup
  		multChDialog.buttons = buttons;//before in show method
  		multChDialog.showMultiChoice(choces,checkedItems);
}
public function openSingleChoiceDialog(event:MouseEvent):void
{
	singleChDialog = new NativeListDialog();
	singleChDialog.theme = NativeListDialog.ANDROID_DEVICE_DEFAULT_LIGHT_THEME;
	singleChDialog.addEventListener(NativeDialogEvent.CANCELED,closeNativeDialogHandler);
	singleChDialog.addEventListener(NativeDialogEvent.OPENED,traceEvent);
	singleChDialog.addEventListener(NativeDialogEvent.CLOSED,closeNativeDialogHandler);

	singleChDialog.addEventListener(ErrorEvent.ERROR,onError);// changed from NativeExtensionErrorEvent
	
	singleChDialog.addEventListener(NativeDialogListEvent.LIST_CHANGE,onListChange);
	singleChDialog.setCancelable(canclebleCheckbox.selected);// before cancleble = true;- can change while in popup
	singleChDialog.buttons = buttons;//before in show method
	singleChDialog.setTitle(titleInput.text); // before title ="Some Title"; - can change while in popup
	singleChDialog.showSingleChoice(choces,selectedIndex);
}
public function closeNativeDialogHandler(event:NativeDialogEvent):void
{
	var dialog:NativeListDialog = (event.target  as NativeListDialog);
	dialog.removeEventListener(NativeDialogEvent.CANCELED,closeNativeDialogHandler);
	dialog.removeEventListener(NativeDialogEvent.CLOSED,closeNativeDialogHandler);
	dialog.removeEventListener(NativeDialogEvent.OPENED,traceEvent);
	dialog.removeEventListener(ErrorEvent.ERROR,onError);// changed from NativeExtensionErrorEvent
	dialog.dispose();//before kill()
}
private function onListChange(event:NativeDialogListEvent):void
{
		var dialog:NativeListDialog = (event.target as NativeListDialog)
	if(dialog.selectedIndex>-1){
		selectedIndex = dialog.selectedIndex;
	}else{
		const a:Vector.<String> = dialog.selectedLabels;
		if(a.length>0){
			for (var i:int = 0; i < a.length; i++) 
			{
				trace(a[i]);
			}
		}
	}
}

Text input Dialog (Android /IOS)

Show a dialog with defined by user input text fields.

NOW ON IOS 4.0 (on IOS 5 uses the new methods) - on ios 4 don't know if Apple will not refuses ###Important:### IOS limitations - There can be only 2 buttons and 2 text inputs. To display message specyfie for the first NativeTextField editable == false

Usage:

public function openTextInputDialog(event:MouseEvent):void{
	if(NativeTextInputDialog.isSupported()){
		textInputDialog = new NativeTextInputDialog();
		textInputDialog.theme = NativeTextInputDialog.ANDROID_HOLO_DARK_THEME;
		
		textInputDialog.addEventListener(NativeDialogEvent.CANCELED,trace);
		textInputDialog.addEventListener(NativeDialogEvent.OPENED,trace);
		textInputDialog.addEventListener(ErrorEvent.ERROR,trace);// changed from NativeExtensionErrorEvent
		textInputDialog.addEventListener(NativeDialogEvent.CLOSED, onTextInputDialogClosedHandler);//before NativeTextInputDialogEvent

		var v:Vector.<NativeTextField> = new Vector.<NativeTextField>();
			
		var ti1:NativeTextField = new NativeTextField(null);
		ti1.text ="enter name and password:";
		ti1.editable = false;
		v.push(ti1);
			
		var ti:NativeTextField = new NativeTextField("name");
		ti.prompText = "name";
		ti.text = "John Doe";
		v.push(ti);
			
		var ti2:NativeTextField = new NativeTextField("password");
		ti2.displayAsPassword = true;
		ti2.prompText = "password";
		ti2.softKeyboardType = SoftKeyboardType.NUMBER;
		ti2.text = "77799";
		v.push(ti2);
			
		textInputDialog.show(titleInput.text,v,buttons);
	}
}
private function onTextInputDialogClosedHandler(event:NativeDialogEvent):void // before NativeTextInputDialogEvent
{
	for each (var n:NativeTextField in event.list) 
	{
		trace(n.name+":  "+n.text);
	}
	trace(event.buttonIndex);
}

Toast (Android / IOS)

For IOS uses : SlideNotification

###Important:### IOS limitations - Toast will always be on the bottom of the screen (both functions work)

Usage:

Toast.show("some message",Toast.LENGTH_LONG);


var randX:int = Math.random()*600;
var randY:int = Math.random()*600;
Toast.showWithDifferentGravit("some message",Toast.LENGTH_SHORT,Toast.GRAVITY_LEFT,randX,randY);

System Properties (Android / IOS)

SystemProperties class can provide some of the missing properties that You can’t get in adobe air

Available parameters:

  • os - like in Capabilities (IOS/Androdi)

  • language - the set language in the system (Android)

  • architecture of the cpu (Android)

  • package name (Android)

  • source directory (Android)

  • application uid -always when a application is installed on device the system creates a unique id for setting up the space for it (Android)

  • UID - created a unique ID for the device based on some of the device properties

  • UDID - ####removed - deprecated on IOS####

  • name - the name of the device (IOS)

  • MACAdress - MAC Adress (IOS)

  • localizedModel (IOS)

  • model (IOS)

**requires **

<uses-permission android:name="android.permission.READ_PHONE_STATE" />

Usage:

if(SystemProperties.isSupported()){
	var dictionary:Dictionary = SystemProperties.getProperites(); 
	for (var key:String in dictionary) 
	{ 
		var readingType:String = key; 
		var readingValue:String = dictionary[key]; 
		trace(readingType + "=" + readingValue); 
	} 
	dictionary = null;
}
This project has been started based on liquid-photo.