• 3 August 2020 for new applications,
• 2 November 2020 for application updates.

1. On Android 10
   • When the application is in the background, it is no longer possible to open a window. For more details, see Behavior of applications in the background.
   • It is no longer possible to get a unique device identifier with SysIMEI and SysSerialNum. "Device owner" applications are not affected by this restriction.
   • It is no longer possible to manipulate WiFi connection parameters by programming. The following functions trigger a fatal error when used in Android 10 or higher: WiFiActivate (syntax to modify activation only), WiFiAddNetwork, WiFiDeleteNetwork, WiFiConnect and WiFiListNetwork.
     "Device owner" applications are not affected by this restriction.
   • The content of the clipboard can no longer be retrieved if the application is in the background. In this case, Clipboard will return an empty string.
2. On Android 10 with API level 29:
   • Applications can no longer access files located on the external storage, outside their specific directories (SysDirExternalStorage with sseApp* constants).
     These files can no longer be accessed in read or write mode. Fixed file paths or paths built from SysDirStorageCard or SysDirExternalStorage with ssePublic* constants must therefore no longer be used. This restriction will be permanent from Android 11, API level 30. On Android 10 (API level 29), some of these locations can still be accessed, so they remain usable with WINDEV Mobile. However, it is recommended to make the necessary adaptations to the applications that access them.
   • Android 10 has implemented a new permission for the functions that allow locating the device: ACCESS_BACKGROUND_LOCATION.
     This permission is automatically added when one of the following functions is used in the application to allow its use in the background:
     

     BeaconDetectBackground	Allows the application to be notified when the device enters into or exits from an area corresponding to the emission radius of a set of Beacon tags.
     BeaconDetectPrecise	Used to find the Beacon tags nearby the device.
     BTLEListDevice	Returns the list of accessible Bluetooth Low Energy devices.
     BTListDevice	Returns the list of accessible Bluetooth devices.
     geoTrackingEnable	Enables the management of location tracking in a WINDEV Mobile application.
     GPSDetectPosition	Asks to be notified when the device gets close to a given position.
     GPSFollowMovement	Asks to be regularly notified about the current device position.
     GPSGetPosition	Retrieves information about the current device position.
     GPSInfo	Returns the information about the location provider used by the application for geolocation functions.
     GPSInitParameter	Initializes the parameters of geolocation WLanguage functions and finds a location provider.
     GPSLastPosition	Retrieves the information about the last known device position.
     GPSStatus	Retrieves the activation status of the geolocation provider or asks to be notified when the status changes.
     GPSStopDetection	Stops the detection of position that was started by GPSDetectPosition.
     MapFollowMovement	Displays the current device position in a Map control and updates this position during its move.
     MobileNetworkConnectionInfo	Returns information regarding the current connection to data on the mobile network.
     WiFiDetectAccessPoint	Starts detecting the Wi-Fi access points currently accessible from the device.

     When this permission is added to the application, the user can allow the access to the device's location when the application in the background, allow the access only when the application is in use, or deny the access. The user can also change these permissions at any time in the Android settings.

Reminder: the target API level ("TargetSdkVersion")

1. Click "Advanced configuration",
2. In the "Advanced configuration" window, select "Edit manifest",
3. Expand the "uses-sdk" node,
4. "android:targetSdkVersion" shows the target API level.

Overview

• when the application is in the background, it can no longer open a window (OpenMobileWindow, Info, Error, Dialog, etc.),
• a WLanguage function that opens a window can no longer be used (SMSRunApp, etc.),
• the Android framework of the application will also be blocked and will not be able to open a window from the background. The following functionalities require opening a window from the background:
  • receiving a push notification,
  • detecting entry or exit from a beacon region (BeaconDetectBackground),
  • receiving a new position when position tracking is enabled (geoTrackingProcedure functions)
  • running tasks in the background (BackgroundTaskxxx functions).

Changes from WINDEV Mobile 25 Update 3

• use WINDEV Mobile 25 "Update 3" to generate it,
• check all processes that can be run from the application in the background : these processes must not open a window. To optimize your code, you can:
  • Use InBackgroundMode to determine whether or not the current process is run in the background.
  • If an application needs to interact with the user while it is in the background, the recommended solution is to display a notification. When the notification is clicked on, the application will be brought back to the foreground and will be allowed to open a window from the procedure called via the ..ActionClick property of the notification (..ActivateApplication must be set to True for the Notification variable).
• when fine-tuning the application on an Android device, use the Android log to identify the origin of a possible crash during background execution. Since a window cannot be opened from the background, the WLanguage security mechanism cannot transmit any information. Errors are logged in the Android log.

List of related functions

AlbumPicker	Retrieves a photo, an image or a video stored in the photo album of the mobile device.
AppointmentCreate	Displays the window for appointment creation of native application for managing appointments found on the Android device.
AppointmentDisplay	Displays an appointment in the native application for managing appointments found on the mobile device (Android or iOS).
AppOpenForm	Opens: the form of an application on Android (Play Store), iOS (App Store) or Windows (Windows Store) in order for the user to give a mark to it and/or to comment it. the form for configuring the In-App purchases of an application.
AuthIdentify	Performs an authentication using the OAuth 2.0 protocol on any webservice.
BCCapture	Decodes the information stored in a bar code by using the device camera (Android, iPhone, iPad).
BTChangeVisibility	Changes the visibility of a Bluetooth radio.
CheckUserIdentity	Allows you to check the real identity of the current user via biometrics check.
Confirm	Displays a message in a standard dialog box that proposes "Yes", "No", "Cancel" and returns the user's choice.
New in version 25 ConfirmAsynchronous	Displays a non-blocking message in a standard dialog box with the answers "Yes", "No", "Cancel" and calls a WLanguage procedure with the user's response.
ContactCreate	Displays the window for contact creation of the native application for contact management found on the device (Android, iPhone or iPad, Universal Windows).
ContactDisplay	Opens the form of a contact in the native application for contact management of the device (Android, iPhone or iPad, Universal Windows).
ContactEdit	Opens the form of a current contact in edit mode in the native application for contact management found on the device (Android, iPhone, iPad, Universal Windows).
ContactSelect	Displays the list of contacts found on the device (Android, iPhone or iPad, Universal Windows).
DatePicker	Displays the system date picker.
Dialog	Displays a message box and returns the value of the button clicked by the user.
New in version 25 DialogAsynchronous	Displays a non-blocking message box and calls a WLanguage procedure with the value of the button clicked by the user.
EmailOpenMail	Opens the default messaging software: of Web user on the browser computer. of the user on the current Windows computer. on the phone.
EmailRunApp	Starts the native application for sending emails found on the current computer: Computer running Windows, Mobile device (Android, iPhone, iPad).
Error	Displays a custom error message in a system error window.
New in version 25 ErrorAsynchronous	Displays a custom error message in a non-blocking system error window.
ErrorBuild	Displays a custom error message in a system error window.
ExeRun	Starts the execution of a program (an executable for example) from the current application.
FBStartSession	Used to authenticate and log in to Faceboook.
geoRunApp	Starts the native mapping application of the device to display: a specific geographical location, an itinerary between two locations.
GglPrintDocument	Prints a document (text or PDF file, images, Word or Excel document, ...) by using the Cloud Print service of Google.
gpwAuthLogin	Allows you to connect to the User Groupware using authentication with an account such as Facebook, Google, Microsoft, etc.
inAppPurchaseProduct	Sends a request for purchasing an "In-App" product associated with the application.
Info	Displays a custom message in a system information window.
New in version 25 InfoAsynchronous	Displays a non-blocking custom message in a system information window.
InfoBuild	Displays a custom message in a system information window.
Input	Displays a message allowing the user to type an information.
New in version 25 KioskDisable	Disables kiosk mode for the current application.
New in version 25 KioskEnable	Switches the current Android application to kiosk mode.
NFCReadTag	Starts reading a NFC tag or enables the detection of NFC tags for the current window.
NFCSendTag	Sends a NFC tag to another device.
NFCWriteTag	Starts writing data onto a NFC tag.
OKCancel	Displays a message in a standard dialog box that proposes "OK" and "Cancel" and returns the user's choice.
New in version 25 OKCancelAsynchronous	Displays a message in a standard non-blocking dialog box with the answers "OK" and "Cancel" and calls a WLanguage procedure with the user's response.
OpenMobileWindow	Opens a window in a mobile application.
ShellExecute	Opens a document in its associated application.
SMSRunApp	Starts the native application for sending SMSs found on the device (Android or iPhone/iPad).
SpeechRecognitionTrigger	Triggers the service for speech recognition on the device.
SpeechSynthesisInitialize	Initializes the parameters of speech synthesis for the current application.
SpeechSynthesisReadFile	Reads the content of the specified file by using the engine for speech synthesis found on the device.
SpeechSynthesisReadText	Reads the specified text using the device's text-to-speech engine.
StartShare	Opens a popup allowing you to select the application that will be used to share a resource (text or document).
tapiDialerCall	Opens the default telephony application (dialer) found on the phone and dials the specified number.
tapiDialerDisplay	Opens the default telephony application (dialer) and displays the specified number. No call is made.
TimePicker	Displays the time picker of system.
URISelect	Opens a system window to select a resource coming: from the device file system, from the Cloud (Google Drive, Microsoft OneDrive, etc.) or from one of the content managers installed on the device.
VideoStartApp	Starts the device's native camera application to record a video or to take a photo.
Warning	Displays a custom message in a system warning window.
New in version 25 WarningAsynchronous	Displays a custom message in a non-blocking system warning window.
YesNo	Displays a message in a standard dialog box that proposes "Yes" and "No" and returns the user's choice.
New in version 25 YesNoAsynchronous	Displays a message in a standard non-blocking dialog box with the answers "Yes" and "No" and calls a WLanguage procedure with the user's response.