Android 11 is shipping on most new phones, but Android 12 has rolled out to Pixel devices everywhere. Join this webinar to see what has changed in these latest versions of Android and look at some best practices for Android development with tips for targeting the latest versions of the most popular operating system.

View or download Google Slides

Desktop, Mobile & Tablet Operating System Market Share Worldwide

https://gs.statcounter.com/os-market-share/desktop-mobile-tablet/worldwide/#monthly-200901-202201

Mobile Manufacturer Market Share Worldwide (Jan 2020 – Jan 2022)

https://gs.statcounter.com/vendor-market-share/mobile/worldwide/#monthly-202001-202202

Mobile Manufacturer Market Share Worldwide (Jan 2022)

https://gs.statcounter.com/vendor-market-share/mobile/worldwide/#monthly-202001-202202

Android vs iOS Market Share Worldwide (Jan 2020 – Jan 2022)

https://gs.statcounter.com/vendor-market-share/mobile/worldwide/#monthly-202001-202202

Mobile Android Version Market Share Worldwide (Jan 2020 – Jan 2022)

https://gs.statcounter.com/android-version-market-share/mobile/worldwide/#monthly-202001-202201

Mobile Android Version – Market Share Worldwide (Jan 2022)

Android Play Security & Performance Requirements

• Each year the targetSdkVersion requirement will advance. Within one year following each Android
• release, new apps and app updates will need to target the updated API level or higher.
• November 2021:
  • Target API level 30 (Android 11)
  • Publish with the Android App Bundle format.
• Required by Google Play Console
• See API migration guide for other changes: developer.android.com/distribute/best-practices/develop/target-sdk

Android Changes in Delphi 11

*** – link

docwiki.embarcadero.com/RADStudio/Alexandria/en/What%27s_New

Support for Android 12?

Upgrading Existing Android Projects

● Open an Android project build with an older version.
● Navigate to the Projects dockable window.
● Select Android 32-bit as the active target platform.
● Right-click on the Libraries node.
● Click on Revert System Files to Default.
● Customize with 3rd party libraries, etc.
● Repeat for Android-64.

Updating Your Android Tools

• Delphi optionally installs Android SDK 25.2.5 and updates during installation
• Add ADB to your path:
  • C:UsersPublicDocumentsEmbarcaderoStudio22.0CatalogRepositoryAndroidSDK-2525-22.0.42600.6491platform-tools
• Add SDKManager to your path:
  • C:UsersPublicDocumentsEmbarcaderoStudio22.0CatalogRepositoryAndroidSDK-2525-22.0.42600.6491toolsbin
• Run:
  • adb kill-server
  • SDKManager —update
  • adb version
• If you get an error “.android/repositories.cfg could not be loaded.”
  • Verify you have a .android folder in your user directory
  • Create an empty repositories.cfg file
• Latest version (as of Feb 2022)
  • Android Debug Bridge version 1.0.41
  • Version 32.0.0-8006631

Wireless Debugging

• Added in Android 11 (API 30)
• Enter developer mode on Android (tap “Build Number” seven times)
• Enable wireless debugging
  • Developer Options -> Wireless Debugging
  • Tap “Pair device with pairing code”
  • Check “Always allow on this network,” then press “Allow” when prompted.
• From Windows CMD
  • adb start-server
  • adb pair [ip]:[port] (from pairing dialog)
  • [pairing code]
  • adb connect [ip]:[port] (from wireless debugging screen)
• Refresh devices in IDE

Android App Bundle Format

Allows Google Play to use Dynamic Delivery application servicing model to generate optimized APKs for each device.

• Project > Options > Building > Delphi Compiler > Compiling
• Generate Android App Bundle file (arm + arm64)

Upon a successful app bundle generation, the IDE presents a dialog containing the .aab file path.

Note: You can not run or debug an App Bundle. To debug the application you have to use .APK package format

docwiki.embarcadero.com/RADStudio/en/Submitting_Your_Android_App_to_Google_Play#Android_App_Bundle_Support

New Android Runtime Permission Model

• Introduced in Android 6.0 (API 23) Marshmallow
  • Support library covers earlier Android versions
• New model streamlines auto-update process
  • Permissions approval triggered at first usage
  • Instead of approving all permissions at install
• Gives end users more control over permissions
  • Individual permissions can be allowed or denied per app, and changed later
• Managed through new Android API methods checkSelfPermission() & requestPermissions()

More information developer.android.com/training/permissions/requesting

Old Permissions Approval Dialog

• During install all permissions are accepted
• User is unable to deny individual permissions
• All permissions publicized in the manifest
• If permissions change, then the must be approved before updating

New Permission Approval Dialog

• First time you request the individual permission, the user has the option to Deny or Allow
• If the user denies once, then the user can prevent the app from asking again
• It is important when and how you ask (more on this later)
• All permissions still publicized in the manifest

Users Have Granular Permission Control Now

Dangerous vs. Normal Permissions

• The user isn’t prompted for Normal permissions
  • Examples: Internet, Vibrate, Bluetooth, etc.
• The user must approve Dangerous permissions
  • Typically these involve privacy or potential cost
  • They are grouped into permission groups:
    • Calendar, Call_Log, Camera, Contacts, Location, Microphone, Phone, Sensors, SMS, & Storage
  • User approves an entire group
    • For example both Sending and Receiving SMS
• The developer still must declare and request all permissions from the OS in the manifest.

More information developer.android.com/guide/topics/permissions/overview

How to Ask for Permission – Delphi

More information: docwiki.embarcadero.com/RADStudio/en/Android_Permission_Model

The Permission Service

• System.Permissions contains an instance of TPermissionsService called PermissionsService or access it via the DefaultService property
  • docwiki:/Libraries/System.Permissions.TPermissionsService
• IsPermissionGranted: if a permission is currently granted to the app
  • docwiki:Libraries/System.Permissions.TPermissionsService.IsPermissionGranted
• RequestPermissions: Request specific permissions and their family
  • docwiki:Libraries/System.Permissions.TPermissionsService.RequestPermissions
• IsEveryPermissionGranted: if listed permissions are currently granted
  • docwiki:Libraries/System.Permissions.TPermissionsService.IsEveryPermissionGranted
• New relevant/related types added to the RTL Android units
  • Manifest.permission and Build.VERSION in Androidapi.JNI.Os.pas
  • ContextCompat, ActivityCompat, and PermissionChecker in Androidapi.JNI.Support.pas

IsPermissionGranted Method

• Member of System.Permissions.TPermissionsService
  • function IsPermissionGranted(const APermission: string): Boolean;
• Find out if a permission is currently granted to the app
  • Never assume it is still granted
• If there is no platform permissions service implemented to actually do any checking, then it defaults to responding that all permissions are granted
  • docwiki:/Libraries/System.Permissions.TPermissionsService

IsEveryPermissionGranted Method

• docwiki:/RADStudio/Uses_Permissions
• docwiki:Libraries/System.Permissions.TPermissionsService.IsEveryPermissionGranted
• Member of System.Permissions.TPermissionsService
  • function IsEveryPermissionGranted(const APermissions: TArray<string>): Boolean;
• Find out if all listed permissions are currently granted
  • Never assume it is still granted
• Permission strings found in TJManifest_permission.JavaClass from Androidapi.JNI.Os
• List of permissions and descriptions

RequestPermissions

• Member of System.Permissions.TPermissionsService
  • procedure RequestPermissions(
  • const APermissions: TArray<string>;
  • const AOnRequestPermissionsResult:
  • TRequestPermissionsResult[Event|Proc];
  • AOnDisplayRationale: TDisplayRationale[Event|Proc] = nil);
• Request one or more permissions
• Any permissions that are not currently granted will be requested.
• Beforehand, a rationale may be displayed to the user when a rationale string has been set for the permission in question requesting a permission again that was previously denied a rationale display routine is passed
• docwiki:Libraries/System.Permissions.TPermissionsService.RequestPermissions

TRequestPermissionsResult[Event|Proc]

• Callback from RequestPermissions
• TRequestPermissionsResult[Event|Proc] =
  • procedure(Sender: TObject;
  • const APermissions: TArray<string>;
  • const AGrantResults: TArray<TPermissionStatus>);
• Callback type for when the system has processed our permission requests
• For each requested permission in APermissions, there is a Boolean in AGrantResults indicating if the permission was granted.
  • docwiki:Libraries/en/System.Permissions.TRequestPermissionsResultEvent
  • docwiki:Libraries/en/System.Permissions.TRequestPermissionsResultProc

When to Ask for Permissions

When to Ask – Critical Permissions

When to Ask – Secondary Permissions

Other Best Practices

• Use Async version of Methods and Dialogs
  • DO NOT block the UI thread!
• Always use HTTPS (everything should be secure)
  • Use the new HTTP Client Libraries docwiki.embarcadero.com/RADStudio/en/Using_an_HTTP_Client
  • Indy is still available, updated, and supported
• Get to know the Parallel Programming Library
  • docwiki.embarcadero.com/RADStudio/en/Using_the_Parallel_Programming_Library
• Get to know System.IOUtils and TPath
  • docwiki.embarcadero.com/RADStudio/en/Standard_RTL_Path_Functions_across_the_Supported_Target_Platforms
• Get to know ADB, logcat & Log.d
  • https://docwiki.embarcadero.com/Libraries/en/FMX.Types.Log.d
  • https://github.com/DelphiWorlds/DeviceLens
  • https://github.com/DelphiWorlds/Codex

More information

• Writing to SD-Card stackoverflow.com/a/57600189/255
• Get Removable SD Card Path
  • Androidapi.JNI.Os.pas
    • getExternalStorageDirectory
    • getExternalStoragePublicDirectory
    • getExternalStorageState
• Check out “Mobile Permissions Component for Android” in GetIt
  • getitnow.embarcadero.com/mobile-permissions-component-for-android/
  • github.com/adrianosantostreina/MobilePermissions/

Next Steps

• Start a RAD Studio trial                   embarcadero.com/products/rad-studio/start-for-free
• Get Community Edition                   embarcadero.com/products/delphi/starter
• Upgrade Today!                               embarcadero.com/app-development-tools-store/rad-studio
• See special offers                            embarcadero.com/radoffer
• Subscribe on YouTube                   youtube.com/c/EmbarcaderoTechnologies
• Follow us on Twitter                       twitter.com/embarcaderotech
• Like us on Facebook                      facebook.com/embarcaderotech
• Follow us on LinkedIn                    linkedin.com/company/embarcadero-technologies
• Read our blog                                  blogs.embarcadero.com

Upgrade to Delphi 11 Today and develop applications on Android 11 & 12 platforms with the use of Android App Builder Software that supports Delphi and C++ environments.