{"id":22441363,"url":"https://github.com/hms-core/hms-toolkit-convertor","last_synced_at":"2025-08-01T18:32:05.364Z","repository":{"id":45626652,"uuid":"272598514","full_name":"HMS-Core/hms-toolkit-convertor","owner":"HMS-Core","description":"Convertor is a code conversion tool supporting Java and Kotlin projects. It helps developers to automatically convert GMS APIs called by apps into corresponding HMS APIs, implementing quick conversion and HMS integration. ","archived":false,"fork":false,"pushed_at":"2021-09-27T08:25:12.000Z","size":9972,"stargazers_count":30,"open_issues_count":4,"forks_count":21,"subscribers_count":18,"default_branch":"master","last_synced_at":"2024-04-16T12:54:17.815Z","etag":null,"topics":["android","convertor","hms","huawei","tool","toolkit"],"latest_commit_sha":null,"homepage":"https://developer.huawei.com/consumer/en/doc/development/Tools-Guides/05673260?ha_source=hms1","language":"Java","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/HMS-Core.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}},"created_at":"2020-06-16T03:14:38.000Z","updated_at":"2023-06-16T03:04:38.000Z","dependencies_parsed_at":"2022-09-23T10:15:22.180Z","dependency_job_id":null,"html_url":"https://github.com/HMS-Core/hms-toolkit-convertor","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HMS-Core%2Fhms-toolkit-convertor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HMS-Core%2Fhms-toolkit-convertor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HMS-Core%2Fhms-toolkit-convertor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HMS-Core%2Fhms-toolkit-convertor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/HMS-Core","download_url":"https://codeload.github.com/HMS-Core/hms-toolkit-convertor/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":228397819,"owners_count":17913540,"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":["android","convertor","hms","huawei","tool","toolkit"],"created_at":"2024-12-06T02:14:15.111Z","updated_at":"2024-12-06T02:14:15.870Z","avatar_url":"https://github.com/HMS-Core.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# HMS Toolkit Convertor\r\n\r\n[![License](https://img.shields.io/badge/Docs-hmsguides-brightgreen)](https://developer.huawei.com/consumer/en/doc/development/Tools-Guides/05673260) ![Apache-2.0](https://img.shields.io/badge/license-Apache-blue)\r\n\r\nEnglish | [中文](https://github.com/HMS-Core/hms-toolkit-convertor/blob/master/README_ZH.md)\r\n\r\n## Table of Contents\r\n\r\n * [Introduction](#introduction)\r\n * [Build](#build)\r\n * [Install](#install)\r\n * [Develop](#run-and-debug-on-ide)\r\n * [Code Contributions](#code-contributions)\r\n * [License](#license)\r\n \r\n## introduction\r\n\r\nConvertor is a code conversion tool supporting Java and Kotlin projects. It helps developers to automatically convert GMS APIs called by apps into corresponding HMS APIs, implementing quick conversion and HMS integration. The HMS Convertor provides the following functions:\r\n\r\n- New Conversion: Automatically converts GMS APIs invoked by an app to HMS APIs.\r\n\r\n- Open Last Conversion: Opens the last conversion result.\r\n\r\n- Save All: Save the corrent project and conversion information.\r\n\r\n- Restore Project: Restores a project with the backup file.\r\n\r\n## Build\r\n\r\n#### Dependencies\r\n\r\nConvertor requires:\r\n\r\n- Gradle(\u003e= 5.2.1)\r\n- JDK(\u003e= 8)\r\n\r\nRun the **git clone** command to download the code, go to the **Convertor/src** directory, and run the following command: \r\n\r\n```shell\r\n$ ./gradlew -p IDE/intellij-plugin buildPlugin\r\n```\r\n\r\nAfter the build is complete, go to the **Convertor/src/IDE/intellij-plugin/build/distributions** directory to view the plugin package in .zip format. \r\n\r\n\r\n## Install\r\n\r\nStart the IDEA or Android Studio and click the menu bar on the upper left, choose **File -\u003e Settings -\u003e Plugins -\u003e Install Plugin from Disk**\r\n\r\n![avatar](https://communityfile-drcn.op.hicloud.com/FileServer/getFile/cmtyPub/011/111/111/0000000000011111111.20200202174355.27600226939014491241655781001918:50510422152457:2800:B7365AA229F3984BF33549A22CB13A9D312E5FD82F0D48ADF1D0102637571B4D.png?needInitFileName=true)\r\n\r\nselect the ZIP plugin package generated during the build.\r\n\r\ntips:\r\n\r\nYou can debug the plugin in the sandbox using the following command:\r\n\r\n```shell\r\n$ ./gradlew -p IDE/intellij-plugin runIde\r\n```\r\n\r\nFor more details, please refer to [Usage Guide](https://developer.huawei.com/consumer/en/doc/development/Tools-Guides/90419706)\r\n\r\n\r\n## Run and Debug on IDE\r\n\r\n1. Clone the repo \r\n\r\n```bash\r\ngit clone https://github.com/HMS-Core/hms-toolkit-convertor.git\r\n\r\n```\r\n\r\n2. If you are using IntelliJ, from the Menu bar, go to `File\u003eOpen..` and open the __src__ folder inside the project.\r\n3. Open the `build.gradle` file, find `alternativeIdePath` property, uncomment it, and set the install path of the intellij IDE that the plugin will be launched on (in this case android studio)\r\n\r\n```\r\n intellij {\r\n\r\n        // [...] \r\n        \r\n         /**\r\n         * Uncomment this for Debugging the plugin on Android Studio directly from the IDE (launches in a separate window/instance)\r\n         * From the menu bar: Run\u003eRun (launches instances with plugin installed) or Run\u003eDebug (debug mode)\r\n         *\r\n         * In this case, we are setting the android studio install path, another IDE/path can be used as well.\r\n        .*/\r\n        // alternativeIdePath '/C://Program Files/Android/Android Studio'\r\n        \r\n        \r\n        // [...] \r\n }\r\n\r\n```\r\n4. From the gradle side toolwindow, click the \"Reload all Gradle Projects\" icon.\r\n5. Now, you can run by choosing Run\u003eRun (launches instance with plugin installed) or Run\u003eDebug (debug mode)\r\n\r\n\r\n\r\n\r\n\r\n\r\n## Code Contributions\r\n\r\nTo make a contribution to Convertor project, follow these steps.\r\n\r\n 1. **Fork** the repo on GitHub \r\n 2. **Clone** the project to your own machine\r\n 3. **Commit** changes to your own branch \r\n 4. **Push** your work back up to your fork\r\n 5. Submit a **Pull request** so that we can review your changes\r\n\r\nNOTE: Be sure to merge the latest from \"upstream\" before making a pull request!\r\n\r\n## Question or issues\r\nIf you want to evaluate more about HMS Core, [r/HMSCore on Reddit](https://www.reddit.com/r/HuaweiDevelopers/) is for you to keep up with latest news about HMS Core, and to exchange insights with other developers.\r\n\r\nIf you have questions about how to use HMS samples, try the following options:\r\n- [Stack Overflow](https://stackoverflow.com/questions/tagged/huawei-mobile-services) is the best place for any programming questions. Be sure to tag your question with \r\n`huawei-mobile-services`.\r\n- [Huawei Developer Forum](https://forums.developer.huawei.com/forumPortal/en/home?fid=0101187876626530001) HMS Core Module is great for general questions, or seeking recommendations and opinions.\r\n\r\nIf you run into a bug in our samples, please submit an [issue](https://github.com/HMS-Core/hms-toolkit-convertor/issues) to the Repository. Even better you can submit a [Pull Request](https://github.com/HMS-Core/hms-toolkit-convertor/pulls) with a fix.\r\n\r\n## License\r\n\r\nHMS Toolkit Convertor is licensed under the [Apache License version 2.0](https://github.com/HMS-Core/hms-toolkit-convertor/blob/master/LICENSE)\r\n\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhms-core%2Fhms-toolkit-convertor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhms-core%2Fhms-toolkit-convertor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhms-core%2Fhms-toolkit-convertor/lists"}