go-hms-push

README

This project was forked from github.com/HMS-Core/hms-push-serverdemo-go.

Table of Contents

• Introduction
• Installation
• Configuration
• Supported Environments
• License

Introduction

Golang sample code encapsulates APIs of the HUAWEI Push Kit server. It provides many sample programs for your reference or usage.

The following describes packages of Golang sample code.

Package	Description
examples	Sample code packages. Each package can run independently.
httpclient	Common package for sending network requests.
push	Package where APIs of the HUAWEI Push Kit server are encapsulated.

Installation

Before using Golang sample code, check whether the Golang environment has been installed. Golang 1.11 or a later version is recommended. Decompress the Golang sample code package.

Copy the org.huawei.com package in the decompressed folder to the project vendor directory in the path specified by GOPATH. Refresh the project and ensure that the file is successfully copied to the destination directory.

Configuration

Golang sample code uses the Client structure in the push package as the entry. Each method in the Client structure calls an API of the HUAWEI Push Kit server. The following describes methods in the Client structure.

Method	Description
SendMessage	Sends a message to a device.

To use functions provided by packages in examples, you need to set related parameters in pushcommon.go in the common package.

The following describes parameters in pushcommon.go.

Parameter	Description
appId	App ID, which is obtained from app information.
appSecret	Secret access key of an app, which is obtained from app information.
authUrl	URL for the Huawei OAuth 2.0 service to obtain a token, please refer to Generating an App-Level Access Token.
pushUrl	URL for accessing HUAWEI Push Kit, please refer to Sending Messages.

The following table describes parameters in target.go.

Parameter	Description
TargetTopic	Name of a topic to be subscribed to, unsubscribed from, or queried.
TargetCondition	Combination of condition expressions for a message.
TargetToken	Token of a target device, which is obtained from the device.
TargetTokenArray	Tokens of all target devices, which are obtained from the devices.

License

pushkit Go sample is licensed under the Apache License, version 2.0.