https://github.com/iansinnott/getting-started-with-phonegap-ios
https://github.com/iansinnott/getting-started-with-phonegap-ios
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/iansinnott/getting-started-with-phonegap-ios
- Owner: iansinnott
- Created: 2014-02-22T09:40:46.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2014-02-24T02:42:40.000Z (over 12 years ago)
- Last Synced: 2025-03-20T03:58:56.312Z (over 1 year ago)
- Language: Objective-C
- Size: 1.67 MB
- Stars: 0
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Getting Started With Phonegap For iOS
This is a quick guide to getting set up to make iOS apps with [Phonegap][phonegap]. This is different from Android development, so if making Android apps is your goal instead, check out [the docs here][android_docs].
### In short:
Make sure that you have [Xcode][xcode] and [Node][nodejs] (and npm) installed. If any of that sounds unfamiliar, follow those links (npm comes with Node). Then open Terminal and do the following:
[xcode]: https://itunes.apple.com/en/app/xcode/id497799835
[nodejs]: http://nodejs.org/
[phonegap]: http://phonegap.com/
[android_docs]: http://docs.phonegap.com/en/edge/guide_platforms_android_index.md.html#Android%20Platform%20Guide
1. `npm install --global phonegap`
2. `phonegap create hello com.example.hello HelloWorld`
3. `phonegap build ios`
**Note:** In step two, the first `hello` is the name of the folder to create the app in. The `com.example.hello` is basically just another name for your app, so change the `example` and `hello` portions to whatever you like. The `HelloWorld` at the very end of the command designates the app name (I think), so call it whatever you like (without spaces).
To run the app in the iOS emulator:
phonegap run ios --emulator
**Note:** The `run` command will do `build` for you, but if you don't want to instantly run the app in the simulator then use `build` separately.
If the iOS simulator node module isn't installed already (it's probably not), then you will need to install it. This is supposed to be automatic, but my copy of Phonegap threw an error for some reason. I this happens just install it manually:
npm install --global ios-sim
**The documentation for Phonegap is seriously out of date, and it doesn't ever seem to distinguish between Cordova and Phonegap in a meaningful way.**
The info on [this page][more_docs] is decent for getting started.
[more_docs]: http://docs.phonegap.com/en/edge/guide_cli_index.md.html#The%20Command-Line%20Interface
### Running on an iPhone or iPad (With a Developer Account)
Make sure your iPhone or iPad is connected via USB and then run:
phonegap run ios --device
This, as with deploying to the simulator is supposed to work automatically out of the box but it also gave me problems when trying to install the necessary dependency, ios-deploy. If you get errors, as above just install manually:
npm install --global ios-deploy
Now you should be able to run your app on iOS :)
**Note:** For the above to work you do need to have an Apple developer account and have already set up your devices for development... or just follow the instructions below.
### Running on a Jailbroken Device without a Developer Account
1. Install AppSync through Cydia. Your jailbroken device should already have Cydia, but in Cydia you probably don't have access to AppSync by default. You will need to add an external Cydia repo that has AppSync. Add one of the repos from [this page on installing AppSync][repos].
2. Download and install [Jailcoder][jailcoder].
3. Open Jailcoder and hit the big button to do a guided install.
That's all, now you can enjoy testing apps on a real device without the need for an apple developer account. That being said, if you want to publish your apps to the App Store you will need a developer account. But $99 per year is probably well worth it if you're going to be publishing apps. Enjoy!
[jailcoder]: http://oneiros.altervista.org/jailcoder/
[repos]: http://www.cydiasources.net/appsync-repo-source.html