After spending some time with it, I think I have a rough idea:

`Mobile Spec` has 3 parts:

1. The main folder is a Cordova app "template" (`config.xml` and
`www`) that includes implementations of various functionalities that
Cordova supports (battery, events, keyboard, lazyloadjs,
splashscreens, sql, storage, misc) that can manually be tested, some
kind of benchmarks, and a link to the automated and manual tests
installed plugins offer (`cdvtests/index.html`).

2. There are 4 plugin folders as well: cordova-plugin-echo,
cordova-plugin-mobilespec-tests, cordova-plugin-thirdparty-tests and
cordova-plugin-whitelist (which is different from the normal
cordova-plugin-whitelist, some testing for it I guess).

3. And then there is `createmobilespec` which includes a script/CLI to
create a Cordova app
a) from the installed Cordova CLI, the current platforms and plugins
(including their tests!), and the 4 local plugins (mode `--global`) or
b) from the local checkouts (via cordova-coho) of all these (CLI,
tools, platforms, plugins...) or
c) with many more modes (to e.g. use plugman and /bin/create instead
of the CLI) I didn't fully figure out or test yet.
(When trying to run 3b, create the app with all `master` of the
tooling, I currently get an error:
https://github.com/apache/cordova-cli/issues/362)

The end result is a folder `mobilespec` with an actual, working
Cordova app that can be installed on devices. It can be used for some
manual testing with the functionality offered by 1) or run the tests
additionally provided by the plugins.

Remain the following questions:

How and when was this usually used?
Was this ever used in a CI context?
How do the benchmarks work and what do they test?

I am currently working on updating the READMEs of the project with
what I learned and will create several PRs that I will announce here
when done.

-J
Am Fr., 23. Nov. 2018 um 19:37 Uhr schrieb Jan Piotrowski
<piotrow...@gmail.com>:
>
> Some historical context:
> https://phonegap.com/blog/2009/11/04/mobile-spec-is-here/
> (original at 
> http://web.archive.org/web/20120428171918/http://blogs.nitobi.com/fil/2009/11/04/mobile-spec-is-here/)
> https://www.youtube.com/watch?v=Vb1oU41mDS0
> http://web.archive.org/web/20160304042105/http://www.feedhenry.com/extending-cordova-mobile-spec-tester-app-cloud/
> Am Fr., 23. Nov. 2018 um 19:20 Uhr schrieb Jan Piotrowski
> <piotrow...@gmail.com>:
> >
> > Hey Cordova veterans,
> >
> > We are currently looking into improving the platform testing, release
> > and voting process (to avoid issues like the broken plugins in
> > cordova-android 7.1.3) in https://github.com/apache/cordova/issues/54
> > There we stumbled over mobile-spec as another form of testing the app.
> >
> > Per its documentation mobile-spec...
> >
> > > ... is a set of automated & manual tests that test Cordova core 
> > > functionality.
> >
> > Can someone share how it came to be, what exactly it does, how and
> > where it is meant to be used? Was it ever used in a CI environment?
> >
> > From a search on GitHub
> > (https://github.com/search?q=org%3Aapache+mobile-spec&type=Code) it
> > seems to be used in some platform test scripts as well.
> >
> > Any documentation or guides we should be aware of?
> >
> > Best,
> > Jan

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@cordova.apache.org
For additional commands, e-mail: dev-h...@cordova.apache.org

Reply via email to