Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/apache/cordova-osx
[DEPRECATED] Apache Cordova OSX
https://github.com/apache/cordova-osx
cordova cordova-platform hacktoberfest javascript nodejs objective-c osx
Last synced: 3 months ago
JSON representation
[DEPRECATED] Apache Cordova OSX
- Host: GitHub
- URL: https://github.com/apache/cordova-osx
- Owner: apache
- License: apache-2.0
- Archived: true
- Created: 2012-12-12T08:00:28.000Z (about 12 years ago)
- Default Branch: master
- Last Pushed: 2022-03-21T08:20:28.000Z (almost 3 years ago)
- Last Synced: 2024-09-26T16:01:19.000Z (3 months ago)
- Topics: cordova, cordova-platform, hacktoberfest, javascript, nodejs, objective-c, osx
- Language: Objective-C
- Homepage: https://cordova.apache.org/
- Size: 16.9 MB
- Stars: 235
- Watchers: 39
- Forks: 85
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
---
📌 **Deprecation Notice**
This repository is deprecated and no more work will be done on this by Apache Cordova. You can continue to use this and it should work as-is but any future issues will not be fixed by the Cordova community.
Feel free to fork this repository and improve your fork. Existing forks are listed in [Network](../../network) and [Forks](../../network/members).
As an alternative you could use the cordova-electron platform or use cordova-ios to build macOS apps.
- Learn more: https://github.com/apache/cordova/blob/master/deprecated.md
---
Cordova OSX
=============================================================
CordovaLib is a framework that enables users to include Cordova in their OS X application projects easily,
and also create new Cordova based OS X application projects.
Note that the current focus of this cordova platform is to provide kiosk-like applications for OSX, that usually run fullscreen and have little desktop interaction. So there is no direct support for menus, dock integration, finder integration, documents, etc. Think of it as a mobile app running on a very big screen.
Pre-requisites
-------------------------------------------------------------
Make sure you have installed the latest released OS X SDK which comes with Xcode 6 or later.
Download it at [http://developer.apple.com/downloads](http://developer.apple.com/downloads)
or the [Mac App Store](http://itunes.apple.com/us/app/xcode/id497799835?mt=12).
Create your project
-------------------------------------------------------------
1. (Optionally) Follow the instructions in the [**Command-Line Usage**](http://cordova.apache.org/docs/en/latest/guide/cli/index.html) section of the [Cordova Docs](http://cordova.apache.org/docs/en/latest/guide/cli/index.html) to create a new project. For example
````
$ cordova create hello com.example.hello HelloWorld
````
2. add the osx platform:
````
$ cordova platform add osx
$ cordova run osx
````
3. You can also open the project in XCode:
````
$ open platforms/osx/.xcodeproj
````
### Add plugins
1. for example, if you need the file-plugin do:
````
$ cordova plugin add cordova-plugin-file
````
Create a Cordova OSX Standalone project
-------------------------------------------------------------
1. Download the source
2. execute the `create` command to setup an empty project:
````
$ bin/create
````
for example
````
$ bin/create ../Foo org.apache.foo FooBar
````
### Add plugins
1. for example, if you need the file-plugin do:
````
$ cordova plugin add cordova-plugin-file
````
Updating a CordovaLib subproject reference in your project
-------------------------------------------------------------
When you update to a new Cordova version, you may need to update the CordovaLib reference in an existing project.
Cordova comes with a script that will help you to do this.
1. Launch **Terminal.app**
2. Go to the location where you installed Cordova, in the `bin` sub-folder
3. Run `update /path/to/your/project`
FAQ
---
### How do debug the webview?
You need to enable the `WebDeveloperExtras` for your bundle:
```
defaults write com.yourcompany.yourbundleid WebKitDeveloperExtras -bool true
```
After you changed the defatuls, start the application and right-click inside the webview and select _Inspect Element_. This opens the Safari Developer Tools.
> **Note**: The _bundleid_ is usually the same as your _widget id_ you define in your `config.xml` unless overridden by the `ios-CFBundleVersion` argument.
MORE INFO
----------
* [http://cordova.apache.org/](http://cordova.apache.org/)