Native Mobile Extension Sample

This sample contains:

• A User Control definition.
• An External Object definition.
• An Android Library project of a GeneXus Module that implements the two previously defined extensions.
• An GeneXus Library definition which declares the Android Library which implements the User Control and External Object in Android and its corresponding GeneXus Module name.
• An implementation for iOS for the User Control and External Object.
• An app that lets you try out both extensions.

Requirements

• GeneXus (latest upgrade is recommended)
• JDK and Android SDK for Android generator
• MAC machine for iOS generator

For more details see:

• Android Requirements for GeneXus.
• iOS Requirements for GeneXus.

Instructions

Import the GeneXus Library definition to GeneXus

• Copy the SampleLibrary directory to the Libraries directory in your GeneXus installation.

Import the User Control definition in GeneXus

• Copy the BasicUserControl directory to the UserControls directory in your GeneXus installation.
• Run genexus.exe /install in a command line in the GeneXus installation directory.

Import the External Object definition in GeneXus

• Open GeneXus and open the KB to work with.
• Import the BasicExternalObject definition from BasicExternalObject\BasicExternalObject.xml.

Import the sample app (optional).

To try out the BasicUserControl and BasicExternalObject samples you may wish to import the sample app from SampleApp\BasicSample.xml.

Android specific

Build and Deploy the GeneXus Android Module to GeneXus

• Set the following system environment variables:
  • GENEXUS_REPO to GeneXus Android Maven repository located in Android\m2repository inside your GeneXus installation (e.g. file:///C:/path/to/GX/Android/m2Repository, making sure it starts with the file scheme).
  • ANDROID_HOME to your Android SDK directory.
• Run the command gradlew publishDebugPublicationToInternalRepository from the SampleModule directory.

Considerations

• Take into account that this project uses the latest FlexibleClient version installed at GENEXUS_REPO. If you need to work with a specific one, you will have to replace it in library/build.gradle file.

Further reading

User Controls

• User Control definition file syntax
• User Control properties file syntax
• External Objects for Smart Devices

External Objects

• External Object definition

Trademarks

GeneXus is a registered trademark of GeneXus S.A. Use of the GeneXus name, logo, or related trademarks must comply with GeneXus S.A.'s trademark guidelines. This project is not officially endorsed by or affiliated with GeneXus S.A. beyond being published by its engineering teams.

Third-party trademarks referenced in this project are the property of their respective owners:

• Android is a trademark of Google LLC.
• Google and Google Play are trademarks of Google LLC.
• Kotlin is a trademark of the Kotlin Foundation, developed by JetBrains s.r.o.
• Gradle is a trademark of Gradle, Inc.
• iOS, macOS, Swift, and Xcode are trademarks of Apple Inc.
• Maven is a trademark of the Apache Software Foundation.

References to these names are for descriptive purposes only and do not imply any endorsement by or affiliation with the respective trademark owners.

License

This project is licensed under the MIT License. See the LICENSE file for more details.