{"id":25667100,"url":"https://github.com/apache/cordova-mobile-spec","last_synced_at":"2025-04-05T06:08:33.283Z","repository":{"id":5687998,"uuid":"6898377","full_name":"apache/cordova-mobile-spec","owner":"apache","description":"Apache Cordova mobile-spec","archived":false,"fork":false,"pushed_at":"2025-03-18T02:04:06.000Z","size":3333,"stargazers_count":65,"open_issues_count":9,"forks_count":107,"subscribers_count":27,"default_branch":"master","last_synced_at":"2025-03-29T05:07:18.568Z","etag":null,"topics":["cordova","cplusplus","csharp","java","javascript","library","mobile","nodejs","objective-c"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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-11-28T08:00:19.000Z","updated_at":"2025-03-23T00:31:46.000Z","dependencies_parsed_at":"2022-08-19T07:51:54.823Z","dependency_job_id":null,"html_url":"https://github.com/apache/cordova-mobile-spec","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-mobile-spec","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apache%2Fcordova-mobile-spec/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apache%2Fcordova-mobile-spec/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apache%2Fcordova-mobile-spec/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/apache","download_url":"https://codeload.github.com/apache/cordova-mobile-spec/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247294539,"owners_count":20915340,"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","cplusplus","csharp","java","javascript","library","mobile","nodejs","objective-c"],"created_at":"2025-02-24T09:21:05.560Z","updated_at":"2025-04-05T06:08:33.263Z","avatar_url":"https://github.com/apache.png","language":"JavaScript","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# Cordova Mobile Spec\n\nThis repository is used to create a Cordova testing application that verifies the core functionality and plugins of **Apache Cordova**.\n\nIts purpose is to be executed as part of the [release process for platforms, plugins, and tools](https://github.com/apache/cordova-coho/tree/master/docs#release-processes).\n\nIt uses the [`cordova-plugin-test-framework`](https://github.com/apache/cordova-plugin-test-framework), which provides the ability for **manual and automated testing**.\n\n_(History: A long time ago, this repository included all manual and automated plugin tests before they were extracted and moved into the respective plugins.)_\n\n---\n\n- [Cordova Mobile Spec](#cordova-mobile-spec)\n  - [Overview](#overview)\n  - [Prerequisites](#prerequisites)\n    - [Setting Up a Cordova Workspace](#setting-up-a-cordova-workspace)\n    - [Installing Interactive CLI Dependencies](#installing-interactive-cli-dependencies)\n    - [Global Command Support (Optional)](#global-command-support-optional)\n  - [Usage](#usage)\n\n---\n\n## Overview\n\nThis repository contains the following:\n\n1. **Template for the Cordova testing app**\n\n    - **`config.xml`**\n\n      The configuration file for the testing application.\n\n    - **`www`**\n\n      This folder contains:\n\n      - A web-based UI template for the testing application.\n      - Pages for manually testing various Cordova functionalities.\n      - Benchmarks and links for triggering manual and automated tests.\n\n      The preconfigured Cordova functionalities include:\n\n      - Battery\n      - Events\n      - Keyboard\n      - LazyloadJS\n      - SQL\n      - Storage\n      - Miscellaneous features\n\n2. **`cordova-plugin-echo` (Internal Plugin)**\n\n   A simple echo function implemented for testing the Cordova bridge.\n\n3. **`cordova-plugin-mobilespec-tests` (Internal Plugin)**\n\n   Contains non-plugin automated tests for Cordova.\n\n4. **Interactive CLI Setup Tool**\n\n   The main tool used to automatically create and configure the Mobile Spec application.\n\n## Prerequisites\n\n### Setting Up a Cordova Workspace\n\nYou should already have a workspace that contains all Cordova repositories. It is **RECOMMENDED** to use `cordova-coho` to set up your workspace, as it will automatically clone all necessary repositories.\n\nYou can also manually set up a workspace, but for this tool to work, the following criteria **MUST** be met:\n\n1. The Cordova workspace directory **MUST** contain at least **one or more active Apache Cordova core plugins**.\n2. The Cordova workspace directory **MUST** contain at least **one or more active Apache Cordova core platforms**.\n3. The Cordova workspace directory **MUST** contain `cordova-plugin-test-framework`.\n4. It is **RECOMMENDED** that the Cordova workspace directory contains the `cordova-mobile-spec` repository.\n\n    - If `cordova-mobile-spec` is inside the Cordova workspace, the interactive CLI tool will automatically detect the other repositories in the parent directory.\n    - If `cordova-mobile-spec` is located elsewhere, you **MUST** specify the workspace path using the `CORDOVA_WORKSPACE` environment variable when running the interactive CLI.\n\n### Installing Interactive CLI Dependencies\n\nRun the following command in the root directory of `cordova-mobile-spec`:\n\n```bash\nnpm install\n```\n\n### Global Command Support (Optional)\n\nTo enable the `mobilespec` command to run from any directory, run the following command in the root directory of `cordova-mobile-spec`:\n\n```bash\nnpm link\n```\n\n\u003e **Note:** The app created when running the `mobilespec` command will be generated in the Cordova workspace.\n\n## Usage\n\nOnce the prerequisites are met, you can launch the interactive CLI tool from the Cordova workspace directory.\n\nIf **Global Command Support** was configured:\n\n```bash\nmobilespec\n```\n\nOr, without global installation:\n\n```bash\nnpx ./cordova-mobile-spec\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapache%2Fcordova-mobile-spec","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fapache%2Fcordova-mobile-spec","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapache%2Fcordova-mobile-spec/lists"}