{"id":13749712,"url":"https://github.com/ccavazos/titanium-alternate-icons","last_synced_at":"2025-05-09T13:30:29.253Z","repository":{"id":218143493,"uuid":"87385165","full_name":"ccavazos/titanium-alternate-icons","owner":"ccavazos","description":"Leverage the ability to change the app icon in iOS 10.3+","archived":false,"fork":false,"pushed_at":"2017-06-14T14:51:03.000Z","size":299,"stargazers_count":24,"open_issues_count":1,"forks_count":4,"subscribers_count":6,"default_branch":"master","last_synced_at":"2024-11-16T00:33:18.336Z","etag":null,"topics":["appcelerator","appcelerator-hyperloop","titanium","titanium-module"],"latest_commit_sha":null,"homepage":null,"language":"Objective-C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ccavazos.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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}},"created_at":"2017-04-06T04:08:56.000Z","updated_at":"2024-04-21T10:32:16.000Z","dependencies_parsed_at":null,"dependency_job_id":"944f649b-9398-4ac9-8ad3-8a7b62da8415","html_url":"https://github.com/ccavazos/titanium-alternate-icons","commit_stats":null,"previous_names":["ccavazos/titanium-alternate-icons"],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ccavazos%2Ftitanium-alternate-icons","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ccavazos%2Ftitanium-alternate-icons/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ccavazos%2Ftitanium-alternate-icons/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ccavazos%2Ftitanium-alternate-icons/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ccavazos","download_url":"https://codeload.github.com/ccavazos/titanium-alternate-icons/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253258097,"owners_count":21879588,"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":["appcelerator","appcelerator-hyperloop","titanium","titanium-module"],"created_at":"2024-08-03T07:01:10.678Z","updated_at":"2025-05-09T13:30:28.771Z","avatar_url":"https://github.com/ccavazos.png","language":"Objective-C","funding_links":[],"categories":["Objective-C"],"sub_categories":[],"readme":"## Alternate App Icon Ti Module (iOS 10.3+)\n\n### Summary\n\nLeverage the ability to change the app icon in iOS 10.3+.\n\n\u003cimg src=\"example/icons.gif\" width=\"320\" alt=\"WhiteIcon\" /\u003e\n\n### Requirements\n\n  - Titanium Mobile SDK 6.0.3.GA or later\n  - iOS 10.3 or later\n  - Xcode 8.3 or later\n\n### Download\n\n  * [Stable release](https://github.com/ccavazos/titanium-alternate-icons/releases)\n\n### Setup\n\nUnzip the module in the `modules/iphone/` folder of your project.\nAdd the module requirement in your `tiapp.xml` file.\n\n```xml\n\u003cmodules\u003e\n    \u003cmodule platform=\"iphone\"\u003eti.alternateicons\u003c/module\u003e\n\u003c/modules\u003e\n```\n\nIn order to use this module with Titanium you will need to disable app thinning by editing the adding the following property in your `tiapp.xml`:\n\n```xml\n\u003cios\u003e\n    \u003cuse-app-thinning\u003efalse\u003c/use-app-thinning\u003e\n\u003c/ios\u003e\n```\n\nAlternatively, you can pass the hashed name of the icon to the methods. You can look up the generated names in `build/iphone/Assets.xcassets`.\n\nNext, you have to declare the icons that you will use in your by adding the following to the `tiapp.xml`. The `\u003ckey\u003e` named `alloyIcon` is the string that you will use to call the `set​Alternate​Icon​Name` method .\n\n```xml\n\u003cios\u003e\n    \u003cdict\u003e\n        \u003ckey\u003eCFBundleIcons\u003c/key\u003e\n        \u003cdict\u003e\n            \u003ckey\u003eCFBundleAlternateIcons\u003c/key\u003e\n            \u003cdict\u003e\n                \u003ckey\u003ealloyIcon\u003c/key\u003e\n                \u003cdict\u003e\n                    \u003ckey\u003eCFBundleIconFiles\u003c/key\u003e\n                    \u003carray\u003e\n                        \u003cstring\u003ealloy\u003c/string\u003e\n                    \u003c/array\u003e\n                \u003c/dict\u003e\n            \u003c/dict\u003e\n            \u003ckey\u003eCFBundlePrimaryIcon\u003c/key\u003e\n            \u003cdict\u003e\n                \u003ckey\u003eCFBundleIconFiles\u003c/key\u003e\n                \u003carray\u003e\n                    \u003cstring\u003eAppIcon\u003c/string\u003e\n                \u003c/array\u003e\n            \u003c/dict\u003e\n        \u003c/dict\u003e\n    \u003c/dict\u003e\n\u003c/ios\u003e\n```\n\nCopy your icons into the `app/assets/` folder. You can try it out with `alloy@2x.png` and `alloy@3x.png` in the example folder of this repo.\n\n### Hyperloop\n\nThis module is also built in Hyperloop to demonstrate the native API access with JavaScript.\nYou can simple require the `ti.alternateicons.js` in your application and run it!\n\n#### Example\n\n```javascript\nvar AlternateIcons = require('ti.alternateicons');\n\nif (AlternateIcons.isSupported()) {\n    AlternateIcons.set​Alternate​Icon​Name('alloyIcon', function(e) {\n        if (!e.success) {\n            Ti.API.error(e.error);\n        }\n    });\n}\n```\n#### Methods\n\n- [x]  `isSupported`\n- [x]  `supportsAlternateIcons`\n- [x]  `alternateIconName`\n- [x]  `set​Alternate​Icon​Name`\n- [x]  `setDefaultIconName`\n\n### Author\n\nCesar Cavazos ([@cesarcvz](https://twitter.com/cesarcvz) / [Web](http://ccavazos.co))\n\n### License\n\nApache 2.0\n\n### Contributing\n\nCode contributions are greatly appreciated, please submit a new [pull request](https://github.com/ccavazos/titanium-alternate-icons/pull/new/master)\n\n### Special Thanks\n\nTo [Hans Knoechel](https://github.com/hansemannn) because this module was created using [titanium-review-dialog](https://github.com/hansemannn/titanium-review-dialog) as a reference.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fccavazos%2Ftitanium-alternate-icons","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fccavazos%2Ftitanium-alternate-icons","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fccavazos%2Ftitanium-alternate-icons/lists"}