Cordova 5.0.0: Which files should I commit to git?

I use Cordova 5.0.0 and i have the following project structure:

MyProject
    - hooks
    - platforms
    - plugins
    - resources
    - www
    - config.xml

My question now is: Which of these folders can I omit? I ask it because I work on three different platforms. I Develop on linux for android, windows for windows phone and on mac for ios. If I commit the whole project I always get warnings and error for the not supported platforms.

What I want is a minimalistic git repository.

One problem for example are the plugins. When I delete the plugin folder from the repository I have to add them on each of my developing platform manually.

Another problem is the resources folder. I automatically generate icons and splashscreens using ionic. When I now try to build the project on ios, it is complaining about the images for android.

So what do I need and what can I omit?

Solution 1:

You can ignore the platforms and plugins directories as long as you haven't added any custom code in them.

When adding plugins and platforms add --save to the command. e.g.

cordova platform add [email protected] --save

or

cordova plugin add cordova-plugin-device --save

This will save a record of the plugins and platforms you use to your config.xml file. When you run cordova prepare or cordova build all of your plugins and platforms listed in config.xml will be installed if they haven't been already.

You can also specify a platform in prepare and build. So if you are on your Mac, you can check out the git repository and run cordova prepare ios to install just the ios platform and plugins.

Solution 2:

It depends on the platforms.

You can use this example of .gitignore and customize according to your needs.

# Mac
.DS_Store

# iOS
platforms/ios/build/
platforms/ios/www/
platforms/ios/cordova/console.log
*.xcuserdatad

# android
platforms/android/assets/www
platforms/android/bin
platforms/android/gen
platforms/android/local.properties
platforms/android/ant-build
platforms/android/ant-gen
platforms/android/CordovaLib/ant-build
platforms/android/CordovaLib/ant-gen
platforms/android/CordovaLib/bin
platforms/android/CordovaLib/gen
platforms/android/CordovaLib/local.properties

# wp8
platforms/wp8/bin
platforms/wp8/obj
platforms/wp8/www
platforms/wp8/.staging
platforms/wp8/*.suo
platforms/wp8/*.csproj.user

# res
resources/signing

Solution 3:

You can save platform and plugin afterwards by using following commands.

platform mass saving

$ cordova platform save

Plugins mass saving

$ cordova plugin save

Kindly note that there is no -- in above commands

One More thing, after fetching repo on another machine you just run following command to generate and fetch plugins and platforms automatically

$ cordova prepare

For more reference visit the links below. https://cordova.apache.org/docs/en/latest/platform_plugin_versioning_ref/#mass-saving-platforms-on-an-existing-project

Cordova Tip: Always refer to official docs before before anything else to get the right solution.

Solution 4:

I don't know the answer, but I've found something that might help. This pull request was approved.

Here's the file :

# Mac
.DS_Store

# Node
npm-debug.log
/node_modules

# Cordova
/platforms
/plugins

# res
resources/signing