{"id":22441409,"url":"https://github.com/hms-core/hms-ecommerce-demo","last_synced_at":"2025-07-03T19:35:35.410Z","repository":{"id":38338865,"uuid":"311644111","full_name":"HMS-Core/hms-ecommerce-demo","owner":"HMS-Core","description":"Build a shopping app by HMS Core kits which shows how to use the HMS Core solution in E-Commerce industry.","archived":false,"fork":false,"pushed_at":"2021-12-14T06:59:47.000Z","size":90772,"stargazers_count":73,"open_issues_count":0,"forks_count":26,"subscribers_count":15,"default_branch":"main","last_synced_at":"2024-04-16T12:54:17.081Z","etag":null,"topics":["app","demo","ecommerce","hms","huawei"],"latest_commit_sha":null,"homepage":"https://developer.huawei.com/consumer/en/solution/hms/ecommerce?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":"CHANGELOG.md","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-11-10T11:57:51.000Z","updated_at":"2024-01-12T01:11:23.000Z","dependencies_parsed_at":"2022-07-18T01:30:44.977Z","dependency_job_id":null,"html_url":"https://github.com/HMS-Core/hms-ecommerce-demo","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-ecommerce-demo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HMS-Core%2Fhms-ecommerce-demo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HMS-Core%2Fhms-ecommerce-demo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HMS-Core%2Fhms-ecommerce-demo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/HMS-Core","download_url":"https://codeload.github.com/HMS-Core/hms-ecommerce-demo/tar.gz/refs/heads/main","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":["app","demo","ecommerce","hms","huawei"],"created_at":"2024-12-06T02:14:26.748Z","updated_at":"2024-12-06T02:14:27.239Z","avatar_url":"https://github.com/HMS-Core.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"English | [中文](README_ZH.md)\n\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"https://github.com/HMS-Core/hms-ecommerce-demo/blob/main/images/logo.png\" width=250\u003e\n\u003c/div\u003e\n\n# HMS E-commerce Demo\n\n## Overview\nHMS Core provides a solution that assists e-commerce apps with quick customer acquisition and improved conversion rates, for sustainable business growth.\n\nThe sample project provides a shopping demo app with related HMS Core kits integrated, demonstrating how to use the HMS Core solution for shopping apps. The demo covers the complete shopping process other than payment.\n\n## Download Link\n[Demo website](https://developer.huawei.com/consumer/en/solution/hms/ecommerce?ha_source=hms7)\n\nScan the QR code for a specific region with your browser to try out the demo app.\n\n\u003ctable\u003e\u003ctr\u003e\n\u003ctd\u003e\n\u003cimg src=\"https://github.com/HMS-Core/hms-ecommerce-demo/blob/main/images/barcode/China.png\" width=\"200\"\u003e\n\u003cp\u003eChina\u003c/p\u003e\n\u003c/td\u003e\n\u003ctd\u003e\n\u003cimg src=\"https://github.com/HMS-Core/hms-ecommerce-demo/blob/main/images/barcode/Asia-Africa-and-Latin-America.png\" width=\"200\"\u003e\n\u003cp\u003eAsia, Africa, and Latin America\u003c/p\u003e\n\u003c/td\u003e\n\u003ctd\u003e\n\u003cimg src=\"https://github.com/HMS-Core/hms-ecommerce-demo/blob/main/images/barcode/Europe.png\" width=200\u003e\n\u003cp\u003eEurope\u003c/p\u003e\n\u003c/td\u003e\n\u003ctd\u003e\n\u003cimg src=\"https://github.com/HMS-Core/hms-ecommerce-demo/blob/main/images/barcode/Russia.png\" width=200\u003e\n\u003cp\u003eRussia\u003c/p\u003e\n\u003c/td\u003e\n\u003c/tr\u003e\u003c/table\u003e\n\n## Features\nDemo app screens and used HMS Core features are as follows:\n- Product list screen\n- Product details screen\n- Favorite products and shopping cart\n- Product display via picture, video, or 3D modeling\n- Search by scanning barcode\n- Product search via picture or voice\n- QR code payment and generation\n- One-tap sign-in and sign-out\n- Product order reminder pushing\n- User location pinpointing\n- User address acquisition\n- Membership service\n- System integrity check\n- User comment and automatic translation of comments\n- AR fitting\n- Bank card recognition\n- Geofence\n- Smart customer service bot\n- Bonus point service\n- Offline store guidance\n- Preferential price marketing\n- Product sharing\n\n\n## App Generation\n**Compilation environment**\n\n- Android Studio: 4.1\n- Android SDK: 19\n- Gradle: 6.3\n\n**Procedure**\n1. Clone the code repository.\n  \n        git clone https://github.com/HMS-Core/hms-ecommerce-demo.git\n\nYou can also download the ZIP package that contains the project.\n\n2. Copy your JKS file and the **agconnect-services.json** file to the **app** directory. For details about how to generate the JKS file and **agconnect-services.json** file, please refer to [Configuring App Information in AppGallery Connect](https://developer.huawei.com/consumer/en/doc/development/HMSCore-Guides/config-agc-0000001050196065?ha_source=hms7).\n\n3. Update the JKS file information and app ID in the app-level **build.gradle** file.\n\n4. Run the following command to compile the demo app:\n\n        cd hms-ecommerce-demo\n        gradle clean\n        gradle build\n\n## Used Kits\n- Account Kit helps you sign in to the app with your HUAWEI ID.\n\n![AccountKit](images/kit-usage-gif-english/AccountKit.gif)\n\n- Scan Kit scans barcodes and QR codes for product viewing and payment, and generates QR codes.\n\n![ScanKit](images/kit-usage-gif-english/ScanKit.gif)\n\nYou can use the following barcode to test the barcode-based purchase function.\n\n![Bar Code](images/barcode.gif)\n\n![ScanKit](images/kit-usage-gif-english/scan-for-payment.gif)\n\n![ScanKit](images/kit-usage-gif-english/QR-Code-generation.gif)\n\n- ML Kit searches for similar products based on the taken picture of a product. \n\n![MLKit](images/kit-usage-gif-english/PhotoShopping.gif)\n\n- Push Kit receives relevant notifications after order placement. \n\n![PushKit](images/kit-usage-gif-english/PushKit.gif)\n\n- Video Kit plays videos related to a product to show the product information.\n\n![VideoKit](images/kit-usage-gif-english/VideoKit.gif)\n\n- Location Kit obtains the current device location, and obtains the device region from the device location. In addition, Location Kit provides the geofence service, which can send messages to users when they enter or exit the specified region.\n\n  ![PushKit](images/kit-usage-gif-english/GroFence.gif)\n\n\n- Identity Kit obtains addresses configured by users to quickly fill in the package delivery address.\n- Analytics Kit obtains basic usage information about the current app to analyze the app usage data for app optimization.\n\n- Scene Kit displays products through 3D modeling.\n\n![SceneKit](images/kit-usage-gif-english/SceneKit.gif)\n\n- In-App Purchases bolsters the membership subscription for enjoying discounts for members.\n\n- Safety Detect evaluates the system integrity during app startup to ensure running environment security.\n\n![SafetyDetect](images/kit-usage-gif-english/SafetyDetect.gif)\n\n- ML Kit provides services such comment translation, bank card recognition, and voice search.\n\n![MLKit](images/kit-usage-gif-english/Translation.gif)![MLKit](images/kit-usage-gif-english/BankCardRecognization.gif)![MLKit](images/kit-usage-gif-english/VoiceSearch.gif)\n\n- AR Engine provides the fitting services such as glasses fitting.\n\n![AREngine](images/kit-usage-gif-english/AR.gif)\n\n- Map Kit and Location Kit display the offline store information and generate the navigation route to the store.\n\n\n![Map/location](images/kit-usage-gif-english/stores-around.gif)\n\n- Search Kit provides the smart customer service bot that automatically replies to questions of users.\n\n\n![Search](images/kit-usage-gif-english/SmartAssistantServices.gif)\n\n- CaaS Engine allows users to share their screens during shopping through the sharing button on the product details screen.\n- Crash Kit records the app crash information.\n- Adding products to favorites: Users can add products to favorites and display them on the favorite product screen.\n- Discount price: Both the original price and discount price are displayed for all products, and the discount price is highlighted. \n- New product: The new product is displayed on an independent screen, and a discount countdown is displayed for the discount activity. Users can subscribe to the product to receive push messages.\n- Member bonus points: When a user purchases a product, bonus points are added to the user's account based on the product amount they bought.\n- Product link sharing: When a user views a product, they can share the product as a link to their friends in social apps, including Alipay, WeChat, and Facebook.\n\n\n## Precautions\nThe shopping demo app simulates the real shopping process. Therefore, the quantity of products in the app is limited. Some functions are unavailable and some others are virtual.\n\n- The product purchase function is virtual, and no fee is deducted.\n- In the app, membership subscription will deduct fees from your account, which will not be refunded. \n- Once membership subscription has been done, you must manually cancel the subscription through the management screen to avoid recurring charges. When a user cancels a subscription they still have membership access until the end of the subscription period.\n- All products in the demo app are virtual.\n- All orders in the demo app are virtual, and no products will be delivered for such orders. \n- All ads in the demo app are for tests.\n- This app allows users to sign in with their HUAWEI IDs. It obtains the user profile and user name from their HUAWEI ID for display in the app.\n\n\n## Technical Support\nYou can visit the [Reddit community](https://www.reddit.com/r/HuaweiDevelopers/) to obtain the latest information about HMS Core and communicate with other developers.\n\nIf you have any questions about the sample code, try the following:\n- Visit [Stack Overflow](https://stackoverflow.com/questions/tagged/huawei-mobile-services?tab=Votes), submit your questions, and tag them with `huawei-mobile-services`. Huawei experts will answer your questions.\n- Visit the HMS Core section in the [HUAWEI Developer Forum](https://forums.developer.huawei.com/forumPortal/en/home?fid=0101187876626530001?ha_source=hms1) and communicate with other developers.\n\nIf you encounter any issues when using the sample code, submit your [issues](https://github.com/HMS-Core/hms-ecommerce-demo/issues) or submit a [pull request](https://github.com/HMS-Core/hms-ecommerce-demo/pulls).\n\n## License\nThe sample code is licensed under [Apache License 2.0](https://github.com/HMS-Core/hms-ecommerce-demo/blob/main/LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhms-core%2Fhms-ecommerce-demo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhms-core%2Fhms-ecommerce-demo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhms-core%2Fhms-ecommerce-demo/lists"}