{"id":15096764,"url":"https://github.com/apache/cordova-osx","last_synced_at":"2025-12-30T08:18:37.823Z","repository":{"id":5907405,"uuid":"7126417","full_name":"apache/cordova-osx","owner":"apache","description":"[DEPRECATED] Apache Cordova OSX","archived":true,"fork":false,"pushed_at":"2022-03-21T08:20:28.000Z","size":17713,"stargazers_count":235,"open_issues_count":0,"forks_count":85,"subscribers_count":39,"default_branch":"master","last_synced_at":"2024-10-02T05:23:12.555Z","etag":null,"topics":["cordova","cordova-platform","hacktoberfest","javascript","nodejs","objective-c","osx"],"latest_commit_sha":null,"homepage":"https://cordova.apache.org/","language":"Objective-C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/apache.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2012-12-12T08:00:28.000Z","updated_at":"2024-07-12T15:21:35.000Z","dependencies_parsed_at":"2022-09-26T20:21:26.615Z","dependency_job_id":null,"html_url":"https://github.com/apache/cordova-osx","commit_stats":null,"previous_names":[],"tags_count":36,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apache%2Fcordova-osx","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apache%2Fcordova-osx/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apache%2Fcordova-osx/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apache%2Fcordova-osx/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/apache","download_url":"https://codeload.github.com/apache/cordova-osx/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":235669382,"owners_count":19026815,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cordova","cordova-platform","hacktoberfest","javascript","nodejs","objective-c","osx"],"created_at":"2024-09-25T16:01:30.168Z","updated_at":"2025-10-08T00:32:00.267Z","avatar_url":"https://github.com/apache.png","language":"Objective-C","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!--\n#\n# Licensed to the Apache Software Foundation (ASF) under one\n# or more contributor license agreements.  See the NOTICE file\n# distributed with this work for additional information\n# regarding copyright ownership.  The ASF licenses this file\n# to you under the Apache License, Version 2.0 (the\n# \"License\"); you may not use this file except in compliance\n# with the License.  You may obtain a copy of the License at\n# \n# http://www.apache.org/licenses/LICENSE-2.0\n# \n# Unless required by applicable law or agreed to in writing,\n# software distributed under the License is distributed on an\n# \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n#  KIND, either express or implied.  See the License for the\n# specific language governing permissions and limitations\n# under the License.\n#\n--\u003e\n\n---\n📌 **Deprecation Notice**\n\nThis 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.\n\nFeel free to fork this repository and improve your fork. Existing forks are listed in [Network](../../network) and [Forks](../../network/members).\n\nAs an alternative you could use the cordova-electron platform or use cordova-ios to build macOS apps.\n\n- Learn more: https://github.com/apache/cordova/blob/master/deprecated.md\n---\n\nCordova OSX\n=============================================================\nCordovaLib is a framework that enables users to include Cordova in their OS X application projects easily, \nand also create new Cordova based OS X application projects.\n\nNote 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.\n\nPre-requisites\n-------------------------------------------------------------\nMake sure you have installed the latest released OS X SDK which comes with Xcode 6 or later. \nDownload it at [http://developer.apple.com/downloads](http://developer.apple.com/downloads) \nor the [Mac App Store](http://itunes.apple.com/us/app/xcode/id497799835?mt=12).\n\n\nCreate your project\n-------------------------------------------------------------\n   \n1. (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\n\n   ````\n   $ cordova create hello com.example.hello HelloWorld\n   ````\n\n2. add the osx platform:\n\n   ````\n   $ cordova platform add osx\n   $ cordova run osx\n   ````\n   \n3. You can also open the project in XCode:\n\n   ````\n   $ open platforms/osx/\u003cyourproject\u003e.xcodeproj\n   ````\n\n\n### Add plugins\n\n1. for example, if you need the file-plugin do:\n\n   ````\n   $ cordova plugin add cordova-plugin-file\n   ````\n    \n\nCreate a Cordova OSX Standalone project\n-------------------------------------------------------------\n\n1. Download the source\n2. execute the `create` command to setup an empty project:\n\n   ````\n   $ bin/create \u003cpath_to_new_project\u003e \u003cpackage_name\u003e \u003cproject_name\u003e\n   ````\n    \n   for example\n    \n   ````\n   $ bin/create ../Foo org.apache.foo FooBar\n   ````\n\n### Add plugins\n\n1. for example, if you need the file-plugin do:\n\n   ````\n   $ cordova plugin add cordova-plugin-file\n   ````\n\n\nUpdating a CordovaLib subproject reference in your project\n-------------------------------------------------------------\n\nWhen you update to a new Cordova version, you may need to update the CordovaLib reference in an existing project. \nCordova comes with a script that will help you to do this.\n\n1. Launch **Terminal.app**\n2. Go to the location where you installed Cordova, in the `bin` sub-folder\n3. Run `update /path/to/your/project` \n\n\n\nFAQ\n---\n### How do debug the webview?\nYou need to enable the `WebDeveloperExtras` for your bundle:\n\n```\ndefaults write com.yourcompany.yourbundleid WebKitDeveloperExtras -bool true\n```\nAfter you changed the defatuls, start the application and right-click inside the webview and select _Inspect Element_. This opens the Safari Developer Tools.\n\n\u003e **Note**: The _bundleid_ is usually the same as your _widget id_ you define in your `config.xml` unless overridden by the `ios-CFBundleVersion` argument.\n \n\n\nMORE INFO\n----------\n* [http://cordova.apache.org/](http://cordova.apache.org/)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapache%2Fcordova-osx","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fapache%2Fcordova-osx","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapache%2Fcordova-osx/lists"}