{"id":28100358,"url":"https://github.com/tidev/karma-titanium-launcher","last_synced_at":"2025-12-26T21:25:07.252Z","repository":{"id":40552026,"uuid":"139721459","full_name":"tidev/karma-titanium-launcher","owner":"tidev","description":"Run your unit tests inside Titanium with Karma","archived":false,"fork":false,"pushed_at":"2025-01-11T17:48:55.000Z","size":840,"stargazers_count":3,"open_issues_count":11,"forks_count":4,"subscribers_count":14,"default_branch":"develop","last_synced_at":"2025-04-29T17:03:48.861Z","etag":null,"topics":["npm-package"],"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/tidev.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"tidev","liberapay":"tidev"}},"created_at":"2018-07-04T12:49:32.000Z","updated_at":"2023-01-31T17:02:01.000Z","dependencies_parsed_at":"2024-03-06T22:51:48.303Z","dependency_job_id":null,"html_url":"https://github.com/tidev/karma-titanium-launcher","commit_stats":null,"previous_names":["appcelerator/karma-titanium-launcher"],"tags_count":28,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tidev%2Fkarma-titanium-launcher","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tidev%2Fkarma-titanium-launcher/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tidev%2Fkarma-titanium-launcher/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tidev%2Fkarma-titanium-launcher/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tidev","download_url":"https://codeload.github.com/tidev/karma-titanium-launcher/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254003561,"owners_count":21997904,"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":["npm-package"],"created_at":"2025-05-13T18:33:50.059Z","updated_at":"2025-12-26T21:25:02.193Z","avatar_url":"https://github.com/tidev.png","language":"JavaScript","funding_links":["https://github.com/sponsors/tidev","https://liberapay.com/tidev"],"categories":[],"sub_categories":[],"readme":"# karma-titanium-launcher\n\n[![Greenkeeper badge](https://badges.greenkeeper.io/appcelerator/karma-titanium-launcher.svg)](https://greenkeeper.io/)\n\n\u003e Run your unit tests inside Axway Titanium.\n\n## Installation\n\nSimply install this launcher as a dev dependency to your existing project:\n\n```bash\nnpm i karma-titanium-launcher -D\n```\n\nThis module also requires the `titanium` CLI to be installed globally in order to create temporary test projects and automatically downloading SDK versions. You can do so with:\n\n```bash\nnpm i titanium -g\n```\n\n\u003e 💡 iOS Testing Note: Version 0.7.0+ of this launcher requires Xcode 10.2 / Swift 5+. If you're still on Swift 4 use version 0.6.0 of this launcher.\n\n## Usage\n\nThis launcher is for testing Titanium apps and native modules as well as plain JS libraries intended to run inside the Titanium runtime. It is typically used in CI to run tests on different platforms. However, it also supports an expirmental rapid TDD setup which allows you to run tests as you write your code.\n\n### Configuring this launcher\n\nTo configure this launcher you have to create `customLaunchers` and set them in the `browsers` option in your Karma configuration.\n\n```js\nmodule.exports = config =\u003e {\n    config.set({\n        // ...\n        customLaunchers: {\n            ios: {\n                base: 'Titanium',\n                browserName: 'iPhone Simulator',\n                platform: 'ios',\n                sdkVersion: '8.0.0.GA'\n            },\n            android: {\n                base: 'Titanium',\n                browserName: 'Android Emulator (Nexus 5X)',\n                platform: 'android',\n                flags: [\n                    '--device-id', 'Nexus_5X_API_27'\n                ]\n            }\n        },\n        browsers: ['android', 'ios']\n    });\n}\n```\n\nYou can select the platform you want to test with the `platform` option. This will prepare your project for unit testing with Karma and launch the basic `titanium build -p [platform]` command.\n\nPlease refer to the following table for a full list of available options.\n\n| Name  | Type | Description |\n| --- | --- | --- |\n| `platform`  | String | Specifies the target platform where your unit tests should be run.  |\n| `flags` | Array | Additional flags to pass to the build command. Refer to `titanium build --help` for a list of available options.  |\n| `sdkVersion` | String | The SDK version used to build the test runner. Defaults to the `\u003csdk-version\u003e` of your `tiapp.xml` (only in app projects) or the currently selected SDK within the `titanium` CLI (check `ti sdk list`) |\n\nYou can also set certain global options that apply to all custom launchers you configure. Global options can be overridden by the individual launcher configuration.\n\n```js\nmodule.exports = config =\u003e {\n    config.set({\n        titanium: {\n            sdkVersion: '8.0.0.GA'\n        }\n    });\n};\n```\n\nSupported global options:\n\n| Name  | Type | Description |\n| --- | --- | --- |\n| `sdkVersion` | String | The SDK version used to build the test runner. Defaults to the `\u003csdk-version\u003e` of your `tiapp.xml` (only in app projects) or the currently selected SDK within the `titanium` CLI (check `ti sdk list`) |\n\n### Example projects\n\nFor example projects that are using this launcher checkout [appcelerator/titanium-vdom](https://github.com/appcelerator/titanium-vdom), [appcelerator/titanized](https://github.com/appcelerator/titanized) or the [titanium-socketio](https://github.com/appcelerator-modules/titanium-socketio) native module.\n\n## Contributions\n\nOpen source contributions are greatly appreciated! If you have a bugfix, improvement or new feature, please create\n[an issue](https://github.com/appcelerator/karma-titanium-launcher/issues/new) first and submit a [pull request](https://github.com/appcelerator/karma-titanium-launcher/pulls/new) against master.\n\n## Getting Help\n\nIf you have questions about unit testing your Titanium apps or libraries with Karma, feel free to reach out on Stackoverflow or the\n`#helpme` channel on [TiSlack](http://tislack.org). In case you find a bug related to this library, create a [new issue](https://github.com/appcelerator/karma-titanium-launcher/issues/new)\nor open a [new JIRA ticket](https://jira.appcelerator.org).\n\n## License\n\nApache License, Version 2.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftidev%2Fkarma-titanium-launcher","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftidev%2Fkarma-titanium-launcher","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftidev%2Fkarma-titanium-launcher/lists"}