https://github.com/apache/cordova-ios

Apache Cordova iOS
https://github.com/apache/cordova-ios

cordova cordova-platform hacktoberfest ios javascript mobile nodejs objective-c

Last synced: about 10 hours ago
JSON representation

Apache Cordova iOS

• Host: GitHub
• URL: https://github.com/apache/cordova-ios
• Owner: apache
• License: apache-2.0
• Created: 2012-11-28T08:00:23.000Z (about 12 years ago)
• Default Branch: master
• Last Pushed: 2024-10-21T15:22:39.000Z (3 months ago)
• Last Synced: 2024-10-29T10:28:36.494Z (3 months ago)
• Topics: cordova, cordova-platform, hacktoberfest, ios, javascript, mobile, nodejs, objective-c
• Language: JavaScript
• Homepage: https://cordova.apache.org/
• Size: 31.3 MB
• Stars: 2,164
• Watchers: 182
• Forks: 988
• Open Issues: 79
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

        


# Cordova iOS

[![NPM](https://nodei.co/npm/cordova-ios.png)](https://nodei.co/npm/cordova-ios/)

[![Node CI](https://github.com/apache/cordova-ios/workflows/Node%20CI/badge.svg?branch=master)](https://github.com/apache/cordova-ios/actions?query=branch%3Amaster)

[![codecov.io](https://codecov.io/github/apache/cordova-ios/coverage.svg?branch=master)](https://codecov.io/github/apache/cordova-ios?branch=master)

Cordova iOS is an iOS application library that allows for Cordova-based projects to be built for the iOS Platform. Cordova based applications are, at the core, applications written with web technology: HTML, CSS and JavaScript.

[Apache Cordova](https://cordova.apache.org/) is a project of [The Apache Software Foundation (ASF)](https://apache.org/).

## Requirements

* Xcode 15.x or greater. Download it at the [Apple Developer - Downloads](https://developer.apple.com/downloads) or the [Mac App Store](https://apps.apple.com/us/app/xcode/id497799835?mt=12).

* [Node.js](https://nodejs.org) 18.x or greater

## Create a Cordova project

Follow the instructions in the [**Create your first Cordova app**](https://cordova.apache.org/docs/en/latest/guide/cli/index.html) section of [Apache Cordova Docs](https://cordova.apache.org/docs/en/latest/)

To use a **shared CordovaLib**, for example in development, link the appropriate cordova-ios platform folder path:

```bash

cordova platform add --link /path/to/cordova-ios

```

## Updating a Cordova project

When you install a new version of the [`Cordova CLI`](https://www.npmjs.com/package/cordova) that pins a new version of the [`Cordova-iOS`](https://www.npmjs.com/package/cordova-ios) platform, you can follow these simple upgrade steps within your project:

```bash

cordova platform rm ios

cordova platform add ios

```

## Debugging in Xcode

Import project in Xcode through _File > Open_ and targeting `/path/to/your-cdv-project/platforms/ios/App.xcworkspace`.

## How to Test Repo Development

```bash

npm install

npm test

```

## Further reading

* [Apache Cordova](https://cordova.apache.org/)

* [Cordova iOS API Documentation](https://apache.github.io/cordova-ios/)