Skip to content

hotwax/receiving

Repository files navigation

receiving

HotWax Commerce receiving app

Build Notes

Clone the repository (code)

  • Open a Terminal window
  • Clone app
  • Go to app directory
  • Run following command to download dependencies npm i

Start App

  • To test the app in browser: ionic serve

https://ionicframework.com/docs/intro/cli -To install Ionic CLI, follow instructions in the above link

Upload instance specific build

  • While adding new configuration, make sure to add them in all of three environments file otherwise it will be missing while building the app for prod or qa instance.
  • Improve the environment variables as per the instance before building the app.
  • Version must be updated before building the app.
  • For dev build, improve the environment variables in environment.ts file and for prod build, improve the environment variables in environment.prod.ts file.
  • Run the command gulp config --channelTag=<dev/prod/qa>
  • After running this command we will have updated environment.ts file and config.xml file as per the updated variables.
  • Next we can build the app using ionic cordova build <android/ios>
  • Upload app on test flight, mention the app release version and what to test under Test Details.

Generating artefact documentation

Following command generates the documentation:
npm run compodoc
Documentation is available in the documentation folder and can be viewed by opening the index.html.

Shopify app configuration and installation

  • Add API Key, Redirect URI and Scopes to environment.
  • For development store, navigate to /shopify page and input shopify store URL
  • For demo store, Generate custom link and install

Build Issues

If you face any error while running the app on a local machine, please refer this.

  • Run following commands to fix the issue npm uninstall @agm/core npm i @agm/core@1.0.0-beta.7 --save

UIWebView Issue while uploading App on testflight:

  • Remove the ios platform using command ionic cordova platform rm ios
  • Check plugin cordova-plugin-ionic-webview in package.json file, If not included then add plugin using command ionic cordova plugin add cordova-plugin-ionic-webview
  • Add the ios platform with version 5.1.0 using command ionic cordova platform add ios@~5.1.0
  • Check following preference in config file . if not present then add it. <preference name="WKWebViewOnly" value="true" />
  • Run following command npm i
  • Build application for IOS ionic cordova build ios

moment-timezone and Truncate

  • If you are getting error Property 'tz' does not exist on type 'typeof moment' npm i moment-timezone@0.5.28
  • If you are getting error A rest parameter must be of an array type. npm i @yellowspot/ng-truncate@1.5.0

Submodule - Theme

  • If you are getting Sass Error like Undefined variable git submodule update --recursive --remote

Contribution Guideline

Please do all changes and in your local systems branch and make a pull request to hacktoberfest branch not in master branch of remote repo