Downloading and Using the Siebel Mobile Archive File (Administrator Task)

Instead of downloading the Siebel app and installing it on a mobile device as described in Downloading and Installing the Siebel App, administrators can copy SiebelMobile.zip file from Siebel Tools installed home directory.

Prerequisite Software

Make sure you have a proper internet connection.

On Windows laptops:
  1. Node.js v22.13 Refer link, https://nodejs.org/download/release/v22.13.0/.

  2. JDK 17. Refer link, https://www.oracle.com/java/technologies/javase/jdk17-archive-downloads.html.

  3. Android Studio and Android SDK Refer link, https://developer.android.com/studio.

    Note: Multiple Android SDK versions will get mapped post Android Studio installation in SDK Manager. You need to select API level 35/36.

On Mac laptops:

  1. Node.js v22.13 Refer link, https://nodejs.org/download/release/v22.13.0/.

  2. JDK 17. Refer link, https://www.oracle.com/java/technologies/javase/jdk17-archive-downloads.html.

  3. Android Studio and Android SDK Refer link, https://developer.android.com/studio.

  4. Xcode 26.4 Refer link, https://developer.apple.com/xcode.

Set Up the Environment

  1. Copy the SiebelMobile.zip archive file.
  2. Extract the SiebelMobile.zip archive file to <PROJECT_ROOT>\RNMobile\.

    The project root folder becomes <PROJECT_ROOT>\RNMobile\Siebel.

Prepare the IPA File

On Mac laptops:

  1. In terminal, navigate to <PROJECT_ROOT>\RNMobile\Siebel\ios folder and execute the pod install command.
  2. Navigate to <PROJECT_ROOT>\RNMobile\siebel\ios\siebel\Info.plist.
    1. Change <string>Release_Version</string> with the appropriate build label.

      Example: <string>23.9</string>

    2. Add a domain list which need to be allowed in the Siebel app:
      <key>WKAppBoundDomains</key>
      <array>
          <string>*.oracle.com</string>
          <string>domain1</string>
          <string>domain2</string>
        ....
      </array>
      
  3. Open the Xcode application using below command in a terminal and navigate to <PROJECT_ROOT>\RNMobile\siebel\ios.

    1. Execute command open siebel.xcworkspace.
    2. With above command it should open the project in Xcode.
    3. Add the Apple signing profile details matching to your company account details.
    4. Clean the Build Folder from the Product menu.
    5. Build from the Product menu.
    6. Select Any iOS Device option from Product > Destination menu item.
    7. Archive the project from the Product menu.

      A successful archive looks something like this image:


      Successful archive UI
    8. Select the Distribute App button and select Custom, and then Enterprise option.
    9. Select the All compatible device variants option from the drop-down menu next to App Thinning.
    10. Select the IOS in house profile and certificate.

      Let the Thinning app package load.

    11. Select export after successful processing.
    12. Once you click export, you can see a folder with all the app versions after thinning.
    13. Pick siebel.ipa from the list to use in the devices.

Or, the IPA file can be generated with the below commands.

  • xcodebuild clean archive -scheme  siebel -configuration Release  -archivePath <PROJECT_ROOT>/siebel/ios/deploy/iOSDebug/Destination_Root/Siebel.xcarchive  -workspace siebel.xcworkspace DEVELOPMENT_TEAM=’<value>’ PROVISIONING_PROFILE=’<value>’
    Example:
    xcodebuild clean archive -scheme siebel -configuration Release -archivePath
    <PROJECT_ROOT>/siebel/ios/deploy/iOSDebug/Destination_Root/Siebel.xcarchive -workspace
    siebel.xcworkspace DEVELOPMENT_TEAM='VYAKS7W7VC' PROVISIONING_PROFILE='Oracle ENT2'
    CODE_SIGN_IDENTITY='iPhone Distribution: Oracle Corporation (Ent 2)'
  • xcodebuild -exportArchive -archivePath<PROJECT_ROOT>/siebel/ios/deploy/iOSDebug/Destination_Root/Siebel.xcarchive -exportPath Siebel.ipa -exportOptionsPlist iosExportOptions.plist -configuration Release

To deploy on an IOS simulator:

In terminal, execute command npx react-native run-ios from <PROJECT_ROOT>\RNMobile\siebel.

Prepare the APK File

Navigate to and open file <PROJECT_ROOT>\RNMobile\siebel\android\app\build.gradle.

Search for defaultConfig section and replace Release_Version with appropriate build label.

On Windows laptops:

  1. Find the local.properties file in the <PROJECT_ROOT>\RNMobile\siebel\android folder. Correct the path value for the sdk.dir parameter. This is required only for Android.

    Example: sdk.dir=C:\\Users\\<Username>\\AppData\\Local\\Android\\Sdk

  2. Add following environment variables (the values are for your reference; use the relevant value, in your case) in the system variables section:
    1. Variable=ANDROID_HOME

      Value=\Users\<Username>\AppData\Local\Android\Sdk

    2. Variable=ANDROID_SDK_ROOT

      Value - \Users\<Username>\AppData\Local\Android\Sdk

    3. Variable=JAVA_HOME

      Value - C:\Program Files\Java\jdk-11

    4. Update Variable=Path with new values:

      \Users\<Username>\AppData\Local\Android\Sdk\emulator\
      \Users\<Username>\AppData\Local\Android\Sdk\platform-tools\
  3. Search for the Windows Powershell in WIN programs. Right-click the mouse and open in Administration mode.

    1. Navigate to the folder path <PROJECT_ROOT>\RNMobile\siebel\android.
    2. Execute these commands:
      • ./gradlew clean
      • ./gradlew build
      • ./gradlew assembleRelease

        Generates the apk file in the path <PROJECT_ROOT>\RNMobile\siebel\android\app\build\outputs\apk\release.

To deploy on an Android emulator:

  1. Execute the command cd .. (to move back to the root folder C:\RNMobile\siebel).
  2. Execute the command npx react-native run-android.

    If you get the error 'react-native' is not recognized as an internal or external command, operable program or batch file, then, execute the command npm install -g react-native-cli.

On Mac laptops:

  1. Find the local.properties file in <PROJECT_ROOT>\RNMobile\siebel\android folder and correct the path value for the sdk.dirparameter.

    For example: sdk.dir=/Users/{mac user}/Library/Android/sdk.

  2. In terminal, navigate to <PROJECT_ROOT>\RNMobile\siebel\android folder and execute these commands:
    • chmod +x gradlew
    • ./gradlew clean
    • ./gradlew build
    • ./gradlew assembleRelease

      Generates apk file under path <PROJECT_ROOT>\RNMobile\siebel\android\app\build\outputs\apk\release

To deploy on an Android emulator:

In terminal, execute the command npx react-native run-android from <PROJECT_ROOT>/siebel.