How to migrate from git submodules to cocoapods

Remove git module files used by git
```
 rm .gitmodules
 rm .git/modules
```

Remove invididual git files/directories used by the submodules

 rm submodule1/{.git/, .gitignore, .gitattributes}
 rm submodule2/{.git/, .gitignore, .gitattributes}
 ...
 rm submoduleN/{.git/, .gitignore, .gitattributes}

Remove git's tracking of the submodule directories

 git rm --cached submodule1
 git rm --cached submodule2
 ...
 git rm --cached submoduleN

Check that submodules aren't being used anymore
```
 git submodule
```

git submodules are no longer in use

 git commit -m "Removed submodule usage"

Remove the code for the ex-submodules, so that we can reinstall them using cocoapods
Install cocoapods on your machine
```
 gem install cocoapods
 pod setup
```
Create and update the podfile
- Go through the 3rd-party projects and see if they are available as pods. If they are, just reference them in the podfile using the versions they specify.
- If a project wasn't available as a pod, check github or github.com/CocoaPods to see if they've since been added as a pod.
- Otherwise, if no pod is available, either stick with submodules or just use the project files as regular files in the project.
Install pods (and follow the instructions/warnings)
```
 pod install
```

Last updated: Nov 5th, 2013

allewun/submodules-to-cocoapods.md

How to migrate from git submodules to cocoapods