Skip to content
Snippets Groups Projects
Select Git revision
  • 498c518f4579ee1a45737eea1ccff03ed0a8cc5c
  • master default protected
  • chrome-manifest-v3
  • feature/migrate-cordova-13
  • feat/improve-network-scan
  • feat/force-migration-check
  • develop
  • feature/encrypted_comment
  • feature/android_api_19
  • gitlab_migration_1
  • rml8
  • v1.7.15-rc1
  • v1.7.14
  • v1.7.13
  • v1.7.12
  • v1.7.11
  • v1.7.10
  • v1.7.9
  • v1.7.8
  • v1.7.7
  • v1.7.6
  • v1.7.5
  • v1.7.4
  • v1.7.3
  • v1.7.2
  • v1.7.1
  • v1.7.0
  • v1.7.0-rc2
  • v1.7.0-rc1
  • v1.6.12
  • v1.6.11
31 results

development_guide.md

Blame
  • Development Guide

    Prerequisite

    To build Cesium, you will have to:

    • Installing build tools:
     sudo apt-get install build-essential
    • Installing nvm
      wget -qO- https://raw.githubusercontent.com/creationix/nvm/v0.31.0/install.sh | bash

    Then reload your terminal, for instance by executing the commande bash

    • Configure NodeJS to use a version 5: (WARNING: upper version will NOT work !)
      nvm install 5
    • Installing node.js build tools:
       npm install -g gulp bower@1.8.0 cordova@6.5.0 ionic@1.7.16

    Get the source code and dependencies

    • Getting source and installing project dependencies:
      git clone git@git.duniter.org:clients/cesium-grp/cesium.git
      cd cesium
      npm install
    • Installing Cordova plugins (need for platforms specific builds)
      ionic state restore
      ionic browser add crosswalk@12.41.296.5
    • This should create a new directory platforms/android

    To remind: check that your command line is configured:

    • You must place yourself in the directory of the application: cd cesium
    • and be configured for NodeJs v5: nvm use 5 (please check using the command node --version)

    Prepare environment, then compile and launch

    • To configure your build environment :

      • Add your environment config into app/config.json

      • Update default configuration, using the command:

      gulp config --env <your_env_name> 

    This will update the configuration file used by cesium, at www/js/config.json.

    • Compiling and running Cesium:
      npm start

    or alternative: ionic serve

    • Open a web browser at address: localhost:8100. The application should be running.

    Best practices for development

    Cesium could be run on phone devices. Please read performance tips on AgularJS + Ionic before starting to contribute. Read also Angular performance for large applicatoins.