# hms-nearby-demo

**Repository Path**: hms-core/hms-nearby-demo

## Basic Information

- **Project Name**: hms-nearby-demo
- **Description**: 华为近距离通信服务示例代码，介绍如何使用Nearby Service的API，可实现近距离wifi分享、近距离文件分享、近场社交等功能。
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 25
- **Forks**: 8
- **Created**: 2021-01-29
- **Last Updated**: 2025-06-04

## Categories & Tags

**Categories**: 5g, harmonyos-communication

**Tags**: None

## README

# HMS Core Nearby Service Sample Code
[![](https://camo.githubusercontent.com/ce1c195eb2524e4e67a2e74bf6e9619555aa0913/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f446f63732d686d736775696465732d627269676874677265656e)](https://developer.huawei.com/consumer/en/doc/development/system-Guides/introduction-nearby-0000001060363166) 

English | [中文](README_ZH.md)

## Contents
 * [Introduction](#Introduction)
 * [Precautions](#Precautions)
 * [Technical Support](#Technical-Support)

## Introduction
This sample code shows how to use APIs of Nearby Service. The project directory is as follows:

1. [NearbyStores](https://github.com/HMS-Core/hms-nearby-demo/tree/master/NearbyStores): provides an Android Studio demo project for beacon management.
2. [NearbyFileTransfer](https://github.com/HMS-Core/hms-nearby-demo/tree/master/NearbyFileTransfer): provides an Android Studio demo project that shows how to develop the file sharing function with only few lines of code.


## Precautions
The sample code contains multiple independent projects. After downloading the code, you can open a project in Android Studio to build a single app or add multiple apps to one project. You can specify the app to build in the **setting.gradle** file.

## Technical Support
You can visit the [Reddit community](https://www.reddit.com/r/HuaweiDevelopers/) to obtain the latest information about HMS Core and communicate with other developers.

If you have any questions about the sample code, try the following:
- 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.
- 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.

If you encounter any issues when using the sample code, submit your [issues](https://github.com/HMS-Core/hms-nearby-demo/issues) or submit a [pull request](https://github.com/HMS-Core/hms-nearby-demo/pulls).