“Dealfly - Delivery app Full App ”

“Delivery app ” Documentation by “Droidev-Technology” v2.0

Introduction


First of all, Thank you so much for purchasing Dealfly Delivery app and for being our loyal customer. You are awesome!
The pages are accompanied by a video tutorial, it is recommended to check both the video and the written documentation..

Requirements

Installing Delivery module on yout project is an easy process , we will guide you through it .
Before getting started, please make sure you have all the requirements done:

  1. You have the latest version of the script Dealfly v2.0 or higher
  2. You have downloaded the module ( zip ) from envato market
  3. You have a valid licence from envato market

Import Delivery module inside your script#back to top



  1. Using a file manager , or an ftp tool you can upload the zip file inside the application/modules repo
  2. Remove nsorder modules from modules repo ( old version ) , we will replace it after with the new version that is compatible with delivery module
  3. Now unzip the file uploaded , and move all folders inside into the application/modules repo
  4. We recommend you to remove the unecessary files and module application/modules/modules and the zip file
  5. Go back to the dashboard applicatio/module manager menu , scroll down to the nsorder module and click update
  6. Now put the purchase code recieved from envato on the input text after clicing on install button on delivery module
  7. Well done , all you need to do now is to go to the new module delivery and configure the delivery fees

Install Android Studio #back to top

In order to start configuration of your android app , you need to install Android studio and the 'Java SE Development Kit'.
First download the android studio from here Android Studio



SDK Manager

The installer , as also shown in the video should automatically download and install all required components . if you want to do manual setup , download at least the following components using the SDK manager

  1. SDK tools
  2. SDK platform Tools
  3. SDK Build Tools
  4. Google Play Services
  5. Android Support Library
  6. Google Repository
  7. Google USB Driver

You can download these SDK , if not installed already , using the SDK manager SDK Manager
After you're done, you can open Android Studio and continue.

Importing Android Project #back to top

To import the template, simply open Android Studio and import/open the template. Make sure to wait for all the processes (the Gradle Build) to complete before continuing to the next step.



  1. First make sure you have installed the latest version of android studio 3.+ , if not please download it from this Link
  2. Unzip your project , then go to android studio and import the project ( click the action Open an existing Android studio project )
  3. Go in to your build.gradle(module app) and change your package name then sync the project
  4. Change the global information in app_config.xml files like BASE_URL , BASE_URL_API , ANDROID_API_KEY , TERMS_OF_USE_URL , PRIVACY_POLICY_URL , DP_HOST_NAME (all this information are be available on your dashboard application > api config )
  5. The final step is to change the logo and the splash of your app, use an Image Editor Tool like photoshop or other to modify this icons, and do not forget to respect the size for chage image , we use lottie plugin for splash animation , please find the more examples on the offical website https://lottiefiles.com/
  6. This URL will help you to generate the icon for app in different dimension , extract all files in this folder [ANDROID_SOURCE_COD]\app\src\main\res (overwrite the old files )
  7. Complete the other changes in app_config.xml and run your app


Commands
  • Open cmd
  • cd C:\Program Files\Java\jdk1.8.0_111\bin
  • keytool -list -v -keystore "C:\Users\YOUR_USERNAME\.android\debug.keystore" -alias androiddebugkey -storepass android -keypass android


  • Changing app icon
    Now we need to put a png file with your icon named 'ic_launcher.png' in the following folders:

    	
                                        res/
                                        mipmap-mdpi/ic_launcher.png (48x48 pixels)
                                        mipmap-hdpi/ic_launcher.png (72x72)
                                        mipmap-xhdpi/ic_launcher.png (96x96)
                                        mipmap-xxhdpi/ic_launcher.png (144x144)
                                        mipmap-xxxhdpi/ic_launcher.png (192x192)
                                        

    this URL will help you resize your images or even create new icon for your app Launcher Icon Generator

    Changing the colors
    You can change your apps colors to create a custom look. The primary color is the color of the Toolbar, some buttons and headers. The primary dark color is used for e.g. the status bar.
    get more color from here https://material.io/guidelines/style/color.html

    Changing description
    To change description and other details like mobile number and section name :

    Setup Deep link :
    set the DP_HOST_NAME using your domain name .
    if you use a subdomain you can put it at on each DP_PATH_PREFIX_XXX

    Setup Firebase project #back to top

    1. Navigate to firebase console ,create a new project with the same package name you mention on android project
    2. If everything went well, firebase will generate a google-service.json file, download it and put it in your computer
    3. Open your android studio , copy the file google-service.json inside the app folder
    4. Return to the firebase console to get the firebase key , settings > Cloud messaging copy your server key and past it in your dashboard field (Application > global config > compaign & notification)

    Enable Phone Number SMS phone verification for your project #back to top

    To sign in users by SMS, you must first enable the Phone Number sign-in method for your Firebase project:

    1. In the Firebase console, open the Authentication section.
    2. On the Sign-in Method page, enable the Phone Number sign-in method.
    3. Make sure to download the google-services.json and replace it inside your android project

    Firebase's phone number sign-in request quota is high enough that most apps won't be affected. However, if you need to sign in a very high volume of users with phone authentication, you might need to upgrade your pricing plan. See the pricing page.

    Enable app verification #back to top

    To use phone number authentication, Firebase must be able to verify that phone number sign-in requests are coming from your app. There are two ways Firebase Authentication accomplishes this:

    • SafetyNet: If a user has a device with Google Play Services installed, and Firebase Authentication can verify the device as legitimate with Android SafetyNet, phone number sign-in can proceed.
    • To enable SafetyNet for use with Firebase Authentication:

      1. In the Google Cloud Console, enable the Android DeviceCheck API for your project. The default Firebase API Key will be used, and needs to be allowed to access the DeviceCheck API.
      2. If you haven't yet specified your app's SHA-256 fingerprint, do so from the Settings Page of the Firebase console. Refer to Authenticating Your Client for details on how to get your app's SHA-256 fingerprint.

    Note : For more detail on how the phone verification works please check the link

    Google maps APis #back to top

    Get Google Admob Api keys
    We have build-in support for Admob banners on all screens and devices. In order to activate Admob ads inside your app, you need to have an Ad UNIT ID. If you don't want ads inside your application, you can disable them ( set value to false ) in app_config.xml like this.
    To get the app IDs & ad unit IDs click on the link https://support.google.com/admob/answer/7356431?hl=en&authuser=3

    After getting the Admob Key update app_config.xml file

    1. First thing , go the Google developer console , in the menu choose APIs & Services > Credentials > Create Credentials > API Key
    2. Copy the key , then go into application restrictions , select Android Apps
    3. Click the link add package and fingerprint
    4. Before filling in the necessary information, ensure that java is already installed on your pc ( use this command to verify java :> java -version , if it's not installed go and download it from this URL )
    5. Locate your debug.keystore from this path C:\Users\[SessionName]\.android\debug.keystore
    6. Go in your CMD , open keytool folder C:\Program Files (x86)\Java\jre1.8.0_144\bin\keytool.exe then execute this command line : keytool -list -v -keystore "[Debug.Keystore path in the previous step]" -alais androiddebugkey -storepass android -keypass android , now copy the SHA1 value
    7. Return to your google console page and enter the package name of your application and the SHA1
    8. One thing you should do to enable google directions in your mobile app is to create a new key without specifing any restriction ( restricition = none ) copy this key and paste it into the app_config.xml files in this map_direction_api_key
    9. final step is to enable the api : Google maps android API , Google maps geolocalisation API , Google maps directions API , Google maps geocoding API
    10. congratulation, you have finished the configuration of google maps , now get the key and set it in your app_config.xml file

    Generate released APK #back to top



    Commands
    1. Open cmd
    2. cd C:\Program Files\Java\jdk1.8.0_111\bin
    3. keytool -list -v -keystore "C:\[YOUR_PATH]\MY_JKS.jks" -alias myalias
    4. Enter your password


    Install Xcode #back to top

    Requirement:
    • XCode 11
    • Swift 5.0

    In order to start configuring , you need to install XCode on your Mac OS



    Importing IOS Project #back to top



    1. First make sure that you have installed the last version of Xcode
    2. Unzip your project , then go to IOS folder > APP and click on Dealify.xc workspace to launch your project inside the xcode
    3. Xcode should be launched now , go to your root folder (Dealify) you can update your app name , bundle identifier , app version
    4. To be able to upload your app on the app store you should have an apple Id to sign the app , you need to create a new one . Once done you can complet the configuration on your app
    5. Open your app config file from this path [Project/config/AppConfig.swift] , this file is required for your app so please make sure you fill all fields correctly to avoid any crash or malfunction of your application during the test
    6. Follow the steps in the previous video to complet the confi of your app
    7. If everything went well , you can run the app after selecting the device
    8. The app should start correctly , if not you need to check the base url , api url and ios_api variables , check also the accessibility of your app through URL
    9. Congratulations the app ready now , enable your network and your gps then start navigating in your awesome app

    Create a firebase project for IOS #back to top



    1. Go to your firebase console ( https://firebase.google.com/ ) and create a new project for your IOS app
    2. The platform asks you the IOS bundle ID of your application, go back to your xcode and copy and paste it in the requested field then enter a name of your app
    3. Now you can download googleservice-info.plist file and place it in your ios project folder , open this file and make sure that the bundle id is the same as in your app
    4. Run your app to verify the installation in your firebase console

    Settings up google maps API Key #back to top

    It is recommended to follow the tutorial provided by google to activate the api google maps on your app .
    click on the following link

    Enable Push notification ( release mode ) #back to top

    1. Open your browser in ( developer.apple.com ) , and click on the right menu Certificates,IDs & profiles
    2. Create a new App ID = bundle ID
    3. In the production section , select Apple push notification service SSL and click continue button and select CertificateSigningRequest ( follow the steps in the video below to generate this file)
    4. Download your app certificate file api.cer
    5. Export your certificated file , enter a new password for that file
    6. Return to your firebase console , and click on the setting menu > cloud messaging > APNs Certificate , now upload your certificate file
    7. Save this changes and go back to your apple developer console , click on menu APP IDs and make sure that the push notification is checked enable in both Development and production mode


    Integrate a new Languages to the app #back to top

    1. Open your root folder , in Localization section create a new Language
    2. Open new language folder and update the value of each field with the translated word in the second column
    3. Make sure to not update the first column
    4. Once done you can save your file

    Thank you & Support #back to top

    I'd like to thank you again for your purchase and I hope you where able to successfully install the app and using it in your future business . If you need support or have some questions. You can visit our support resources here at SUPPORT.

    What support does include
    1. Answers to (technical) questions about the item's features
    2. Assistance with reported bugs and issues
    3. Answers to questions about importing and setting up the item as is described in the docs.
    Please note that support does not include:
    1. Customization & adding new features
    2. Installation Services
    3. Support for 3rd party software and/or plugins
    4. Content related rejections and violations from Google

    We do provide these extra services as freelance work. Contact as at (droideve.tech@gmail.com)