apache / cordova-test-platform

Apache cordova

cordova-test-platform

This repo contains the code for an Apache Cordova platform that allows you to build applications that target NOTHING. This platform is purely for testing, although it is also a good resource to see the minimum requirements to implement a new platform.

Apache Cordova is a project of The Apache Software Foundation (ASF)

How to Use This

This repository contains a reference implementation of Cordova's Platform API. The Platform API defines interfaces for Cordova tooling to be able to create, build/compile, run/emulate and clean Cordova projects targeted at a specific platform. Core Cordova platforms such as cordova-android and cordova-ios implement this API. This API is then used by tools such as cordova-cli and cordova-lib when managing platform-specific actions in cross-platform Cordova projects.

Further Reading

• Apache Cordova Documentation
• apache/cordova-discuss#9
• apache/cordova-discuss#12

cordova-test-platform's Issues

Add CI for tests on all platforms

Windows, Linux, macOS, simple npm test

Test fails locally on Windows

> [email protected] test E:\Projects\Cordova\cordova-test-platform
> npm run jshint && jasmine


> [email protected] jshint E:\Projects\Cordova\cordova-test-platform
> jshint src && jshint spec

Started
.FFFFFF.Creating Cordova project for cordova-platform-test:
	Path: C:\Users\Jan\AppData\Local\Temp\cordova-test-platform-AcBYm0
	Name: HelloCordova
...........

Failures:
1) create create project with ascii name, no spaces
  Message:
    Expected 1 to be 0.
  Stack:
    Error: Expected 1 to be 0.
        at createAndBuild (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:44:25)
        at UserContext.<anonymous> (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:81:9)
  Message:
    Expected false to be true.
  Stack:
    Error: Expected false to be true.
        at createAndBuild (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:51:70)
        at UserContext.<anonymous> (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:81:9)
  Message:
    Expected false to be true.
  Stack:
    Error: Expected false to be true.
        at createAndBuild (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:52:70)
        at UserContext.<anonymous> (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:81:9)
  Message:
    Expected false to be true.
  Stack:
    Error: Expected false to be true.
        at createAndBuild (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:53:68)
        at UserContext.<anonymous> (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:81:9)
  Message:
    Expected false to be true.
  Stack:
    Error: Expected false to be true.
        at createAndBuild (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:54:68)
        at UserContext.<anonymous> (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:81:9)
  Message:
    Expected false to be true.
  Stack:
    Error: Expected false to be true.
        at createAndBuild (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:55:72)
        at UserContext.<anonymous> (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:81:9)
  Message:
    Expected 1 to be 0.
  Stack:
    Error: Expected 1 to be 0.
        at createAndBuild (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:62:25)
        at UserContext.<anonymous> (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:81:9)

2) create create project with ascii name, and spaces
  Message:
    Expected 1 to be 0.
  Stack:
    Error: Expected 1 to be 0.
        at createAndBuild (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:44:25)
        at UserContext.<anonymous> (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:88:9)
  Message:
    Expected false to be true.
  Stack:
    Error: Expected false to be true.
        at createAndBuild (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:51:70)
        at UserContext.<anonymous> (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:88:9)
  Message:
    Expected false to be true.
  Stack:
    Error: Expected false to be true.
        at createAndBuild (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:52:70)
        at UserContext.<anonymous> (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:88:9)
  Message:
    Expected false to be true.
  Stack:
    Error: Expected false to be true.
        at createAndBuild (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:53:68)
        at UserContext.<anonymous> (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:88:9)
  Message:
    Expected false to be true.
  Stack:
    Error: Expected false to be true.
        at createAndBuild (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:54:68)
        at UserContext.<anonymous> (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:88:9)
  Message:
    Expected false to be true.
  Stack:
    Error: Expected false to be true.
        at createAndBuild (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:55:72)
        at UserContext.<anonymous> (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:88:9)
  Message:
    Expected 1 to be 0.
  Stack:
    Error: Expected 1 to be 0.
        at createAndBuild (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:62:25)
        at UserContext.<anonymous> (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:88:9)

3) create create project with unicode name, no spaces
  Message:
    Expected 1 to be 0.
  Stack:
    Error: Expected 1 to be 0.
        at createAndBuild (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:44:25)
        at UserContext.<anonymous> (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:95:9)
  Message:
    Expected false to be true.
  Stack:
    Error: Expected false to be true.
        at createAndBuild (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:51:70)
        at UserContext.<anonymous> (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:95:9)
  Message:
    Expected false to be true.
  Stack:
    Error: Expected false to be true.
        at createAndBuild (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:52:70)
        at UserContext.<anonymous> (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:95:9)
  Message:
    Expected false to be true.
  Stack:
    Error: Expected false to be true.
        at createAndBuild (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:53:68)
        at UserContext.<anonymous> (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:95:9)
  Message:
    Expected false to be true.
  Stack:
    Error: Expected false to be true.
        at createAndBuild (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:54:68)
        at UserContext.<anonymous> (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:95:9)
  Message:
    Expected false to be true.
  Stack:
    Error: Expected false to be true.
        at createAndBuild (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:55:72)
        at UserContext.<anonymous> (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:95:9)
  Message:
    Expected 1 to be 0.
  Stack:
    Error: Expected 1 to be 0.
        at createAndBuild (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:62:25)
        at UserContext.<anonymous> (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:95:9)

4) create create project with unicode name, and spaces
  Message:
    Expected 1 to be 0.
  Stack:
    Error: Expected 1 to be 0.
        at createAndBuild (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:44:25)
        at UserContext.<anonymous> (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:102:9)
  Message:
    Expected false to be true.
  Stack:
    Error: Expected false to be true.
        at createAndBuild (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:51:70)
        at UserContext.<anonymous> (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:102:9)
  Message:
    Expected false to be true.
  Stack:
    Error: Expected false to be true.
        at createAndBuild (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:52:70)
        at UserContext.<anonymous> (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:102:9)
  Message:
    Expected false to be true.
  Stack:
    Error: Expected false to be true.
        at createAndBuild (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:53:68)
        at UserContext.<anonymous> (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:102:9)
  Message:
    Expected false to be true.
  Stack:
    Error: Expected false to be true.
        at createAndBuild (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:54:68)
        at UserContext.<anonymous> (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:102:9)
  Message:
    Expected false to be true.
  Stack:
    Error: Expected false to be true.
        at createAndBuild (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:55:72)
        at UserContext.<anonymous> (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:102:9)
  Message:
    Expected 1 to be 0.
  Stack:
    Error: Expected 1 to be 0.
        at createAndBuild (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:62:25)
        at UserContext.<anonymous> (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:102:9)

5) create create project with ascii+unicode name, no spaces
  Message:
    Expected 1 to be 0.
  Stack:
    Error: Expected 1 to be 0.
        at createAndBuild (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:44:25)
        at UserContext.<anonymous> (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:109:9)
  Message:
    Expected false to be true.
  Stack:
    Error: Expected false to be true.
        at createAndBuild (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:51:70)
        at UserContext.<anonymous> (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:109:9)
  Message:
    Expected false to be true.
  Stack:
    Error: Expected false to be true.
        at createAndBuild (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:52:70)
        at UserContext.<anonymous> (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:109:9)
  Message:
    Expected false to be true.
  Stack:
    Error: Expected false to be true.
        at createAndBuild (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:53:68)
        at UserContext.<anonymous> (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:109:9)
  Message:
    Expected false to be true.
  Stack:
    Error: Expected false to be true.
        at createAndBuild (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:54:68)
        at UserContext.<anonymous> (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:109:9)
  Message:
    Expected false to be true.
  Stack:
    Error: Expected false to be true.
        at createAndBuild (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:55:72)
        at UserContext.<anonymous> (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:109:9)
  Message:
    Expected 1 to be 0.
  Stack:
    Error: Expected 1 to be 0.
        at createAndBuild (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:62:25)
        at UserContext.<anonymous> (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:109:9)

6) create create project with ascii+unicode name, and spaces
  Message:
    Expected 1 to be 0.
  Stack:
    Error: Expected 1 to be 0.
        at createAndBuild (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:44:25)
        at UserContext.<anonymous> (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:116:9)
  Message:
    Expected false to be true.
  Stack:
    Error: Expected false to be true.
        at createAndBuild (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:51:70)
        at UserContext.<anonymous> (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:116:9)
  Message:
    Expected false to be true.
  Stack:
    Error: Expected false to be true.
        at createAndBuild (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:52:70)
        at UserContext.<anonymous> (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:116:9)
  Message:
    Expected false to be true.
  Stack:
    Error: Expected false to be true.
        at createAndBuild (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:53:68)
        at UserContext.<anonymous> (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:116:9)
  Message:
    Expected false to be true.
  Stack:
    Error: Expected false to be true.
        at createAndBuild (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:54:68)
        at UserContext.<anonymous> (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:116:9)
  Message:
    Expected false to be true.
  Stack:
    Error: Expected false to be true.
        at createAndBuild (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:55:72)
        at UserContext.<anonymous> (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:116:9)
  Message:
    Expected 1 to be 0.
  Stack:
    Error: Expected 1 to be 0.
        at createAndBuild (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:62:25)
        at UserContext.<anonymous> (E:\Projects\Cordova\cordova-test-platform\spec\create.spec.js:116:9)

19 specs, 6 failures
Finished in 7.306 seconds

src/cordova/* scripts are not described anywhere

https://github.com/apache/cordova-test-platform/tree/master/src/cordova has several files besides Api.js that are not described anywhere:

build, clean, log, run, version, version.bat

Api.updatePlatform is missing in PlatformRequirements.md

... but defined in Api.js:

cordova-test-platform/src/cordova/Api.js

Lines 77 to 81 in 4d2212c

	Api.updatePlatform = function (destination, options) {
	events.emit('log', "test-platform:Api:updatePlatform");
	// todo?: create projectInstance and fulfill promise with it.
	return Promise.resolve();
	};

Optional? Obsolete?

Api.js doesn't follow PlatformRequirements.md

https://github.com/apache/cordova-test-platform/blob/master/src/cordova/Api.js vs. https://github.com/apache/cordova-test-platform/blob/master/PlatformRequirements.md

cordova-test-platform/src/cordova/Api.js

Lines 125 to 128 in 4d2212c

	Api.prototype.requirements = function() {
	events.emit('log', "test-platform:Api:requirements");
	return true;
	};

vs.

https://github.com/apache/cordova-test-platform/blob/master/PlatformRequirements.md#platformapiprototyperequirements--function-

The .requirements must return a promise, resolved with a set of Requirement objects for the current platform.

Returns true

cordova-test-platform/src/cordova/Api.js

Lines 116 to 118 in 4d2212c

	Api.prototype.run = function(runOptions) {
	events.emit('log', "test-platform:Api:run");
	};

vs

https://github.com/apache/cordova-test-platform/blob/master/PlatformRequirements.md#platformapiprototyperun--functionrunoptions-

.run must return a promise either fulfilled if the package was build and ran successfully, or rejected with a CordovaError.

Returns nothing