Installation & Setup

This guide walks you through installing Shipedge Warehouse Pro on your Android device and completing the initial setup. Follow these steps to get started with warehouse operations on your mobile device.

Before You Begin

Make sure you have your Shipedge warehouse credentials and warehouse name ready. You’ll need these during the initial setup process.

System Requirements

Before installing, verify your device meets these requirements:

Android Version:

• Minimum: Android 5.0 Lollipop (API level 21)
• Target: Android 14 (API level 34)
• Recommended: Android 8.0 or higher for best performance

Device Requirements:

• Android smartphone or tablet
• Internet connection (Wi-Fi or mobile data)
• At least 100 MB of free storage space
• Bluetooth capability (for scanner support, optional)

Required Permissions: The app will request these permissions during installation and first launch:

• Bluetooth - For connecting Bluetooth barcode scanners
• Internet - For synchronizing data with Shipedge server
• Network Access - For checking connection status
• Camera - Optional, for barcode scanning using device camera
• Storage - For local database and cached data
• Phone State - For device identification

Installation Methods

Shipedge Warehouse Pro is distributed as an APK file. Installation methods depend on your organization’s setup.

Method 1: Direct APK Installation

1. Obtain the APK file

   Get the shipedge.android-release.apk file from your administrator or download it from your organization’s distribution source.

2. Enable Unknown Sources

   On your Android device:

   • Go to Settings > Security (or Settings > Apps > Special access on newer devices)
   • Enable Install unknown apps or Unknown sources
   • Select the app you’ll use to install (File Manager, Chrome, etc.)

3. Install the APK

   • Open the APK file using your file manager
   • Tap Install when prompted
   • Wait for installation to complete
   • Tap Open or find the app icon in your app drawer

4. Verify Installation

   Look for the “Shipedge Warehouse pro” app icon in your app drawer. The app should launch when tapped.

Method 2: Enterprise Distribution

If your organization uses Mobile Device Management (MDM) or enterprise distribution:

1. Follow your IT administrator’s instructions
2. The app may be pushed to your device automatically
3. You may need to approve the installation when prompted

Initial Setup

After installation, complete the initial setup process:

1. Launch the App

   Tap the Shipedge Warehouse pro icon from your app drawer. The app opens to the login screen.

2. Grant Permissions

   When prompted, grant the required permissions:

   • Camera - Tap Allow if you plan to use the camera for barcode scanning
   • Storage - Tap Allow for local data storage
   • Bluetooth - Tap Allow if you’ll use Bluetooth scanners

   Permission Requests

   On Android 6.0 and higher, some permissions are requested at runtime. You can change these later in your device’s app settings.

3. Enter Warehouse Information

   On first launch, you’ll see a message: “The first time should insert name of warehouse”

   • Enter your warehouse name
   • Enter your warehouse key (provided by your administrator)
   • Tap OK to continue

4. Device Verification

   The app verifies your device:

   • Checks device activation status
   • Validates warehouse connection
   • Displays “Please wait - Verifying warehouse” during this process

5. Complete Setup

   Once verification completes:

   • Your device is registered with the Shipedge server
   • Local database is initialized
   • You’re ready to sign in

Device Security Checks

The app performs several security checks during startup:

Automatic Checks:

• Rooted Devices - The app will not run on rooted devices for security reasons
• Debugger Detection - Debuggers are detected and the app closes
• Emulator Detection - Some emulator environments are blocked

What This Means:

• Use only approved, non-rooted devices
• Don’t attempt to run the app in development environments
• Contact your administrator if you see security-related messages

Post-Installation Configuration

After successful installation and initial setup:

Verify Installation

Check App Version:

• The app version is 25.7.1 (versionCode: 203)
• You can verify this in your device’s app settings if needed

Test Basic Functionality:

• Launch the app
• Verify the login screen appears
• Check that you can enter warehouse information
• Confirm internet connection is working

Configure Bluetooth (Optional)

If you’ll use a Bluetooth scanner:

• See the Bluetooth Scanner Setup guide for detailed instructions
• You can configure Bluetooth from the login screen or main menu

Set Up Your Account

• Proceed to Login & Authentication to sign in
• Use credentials provided by your administrator
• Your user permissions determine which features you can access

💡 Best Practices

Use Approved Devices

Only install the app on devices approved by your IT administrator. Rooted or modified devices may be blocked.

Keep App Updated

Install app updates when provided by your administrator to ensure you have the latest features and security fixes.

Secure Your Device

Use device lock screen protection (PIN, pattern, or fingerprint) to protect warehouse data if your device is lost or stolen.

Check Storage Space

Ensure you have sufficient storage space. The app uses local SQLite database that grows with usage. Clear cache if needed.

Troubleshooting Installation

Installation Fails

“App not installed” error:

• Check that you have enough storage space (at least 100 MB free)
• Verify the APK file isn’t corrupted (re-download if needed)
• Ensure “Unknown sources” is enabled in device settings
• Try restarting your device and attempting installation again

“Package installer has stopped” error:

• Clear cache for Package Installer app in device settings
• Restart your device
• Try installing from a different file manager app

App Won’t Launch

App closes immediately after opening:

• Check if your device meets minimum Android version (5.0+)
• Verify device isn’t rooted (app blocks rooted devices)
• Ensure you’re not running a debugger
• Check device storage space

“Device not activated” message:

• Contact your administrator to activate your device
• Verify you entered the correct warehouse name and key
• Check your internet connection

Permission Issues

Permissions not granted:

• Go to Settings > Apps > Shipedge Warehouse pro > Permissions
• Enable required permissions manually
• Restart the app after granting permissions

Bluetooth not working:

• Verify Bluetooth is enabled in device settings
• Check that location services are enabled (required for Bluetooth scanning on Android 6.0+)
• See Bluetooth Scanner Setup for detailed troubleshooting

First-Time Setup Issues

“The first time should insert name of warehouse” message:

• This is normal on first launch
• Enter your warehouse name exactly as provided by your administrator
• Enter the warehouse key correctly
• Tap OK to proceed

Warehouse verification fails:

• Check your internet connection
• Verify warehouse name and key are correct
• Contact your administrator if the warehouse name isn’t recognized
• Error message: “No connection to internet or error on warehouse name” indicates connection or warehouse name issue

Uninstalling the App

To remove Shipedge Warehouse Pro:

1. Go to Settings > Apps > Shipedge Warehouse pro
2. Tap Uninstall
3. Confirm removal when prompted

Data Loss

Uninstalling the app removes all local data including cached inventory, pending orders, and settings. Make sure all data is synchronized before uninstalling.

Next Steps

After successful installation:

• Login & Authentication - Sign in to your account
• Main Menu Navigation - Learn how to navigate the app
• Bluetooth Scanner Setup - Connect your Bluetooth scanner
• App Overview - Review app features and capabilities

Technical Details

Package Name: shipedge.rep

App Icon: @drawable/logoshipedge

Database: SQLite database named androidShipedge stored locally

Settings Table: Stores warehouse configuration, status, and keys

Device Identification: Uses Android ID (Secure.ANDROID_ID) for device registration

Minimum SDK: API 21 (Android 5.0 Lollipop)

Target SDK: API 34 (Android 14)

Compile SDK: API 33

MultiDex: Enabled for large app size support

---

Next: Login & Authentication or App Overview