English | 中文
The sample code for Golang encapsulates the server-side APIs of Push Kit, for your reference or direct use.
The following table describes packages of Golang sample code.
| Package | Description |
|---|---|
| examples | Sample code packages. |
| httpclient | Package for sending network requests. |
| push | Package where Push Kit server APIs are encapsulated. |
Install the Golang environment (Golang 1.11 or later is recommended) and decompress the Golang sample code package.
Copy org.huawei.com in the decompressed package to the vendor directory in the path specified by GOPATH in your project. Refresh the project to ensure that the copied file exists in the directory.
Start configuration with the Client structure in the push package. Each method in the Client structure can be used to call an API of the Push Kit server. The following table describes the method in the Client structure.
| Method | Description |
|---|---|
| SendMessage | Sends a message to a device. |
To use the functions provided by the packages in examples, set related parameters in pushcommon.go in the common package.
The following table describes the parameters in pushcommon.go.
| Parameter | Description |
|---|---|
| appId | App ID, which is obtained from the app information. |
| appSecret | App secret, which is obtained from the app information. |
| authUrl | URL for Huawei OAuth 2.0 to obtain a token. For details, please refer to OAuth 2.0-based Authentication. |
| pushUrl | Access address of Push Kit. For details, please refer to Downlink Message Sending. |
The following table describes the parameters in target.go.
| Parameter | Description |
|---|---|
| TargetTopic | Name of the topic to be subscribed to, unsubscribed from, or queried. |
| TargetCondition | Combined condition expression for sending a message. |
| TargetToken | Token of a target device, which is obtained from the target device. |
| TargetTokenArray | Tokens of all target devices, which are obtained from these target devices. |
-
Send a data message to an Android app. You can obtain the initialized MessageRequest instance of the data message using the NewTransparentMsgRequest method in the push > model package. File path: examples/send_data_message/main.go
-
Send a notification message to an Android app. You can obtain the initialized MessageRequest instance of the data message using the NewNotificationMsgRequest method in the push > model package. File path: examples/send_notify_message/main.go
-
Send a message by topic. You can send a notification or data message by topic. After obtaining the MessageRequest instance, you can customize a topic. File path: examples/send_topic_message/main.go
-
Send a message by condition. You can send a notification or data message by condition. After obtaining the MessageRequest instance, you can customize a condition. File path: examples/send_condition_message/main.go
-
Send a message to a Huawei quick app. You can set the FastAppTarget attribute for this messaging. File path: examples/send_instance_app_message/main.go
-
Send a message by APNs. You can set the Apns attribute for this messaging. File path: examples/send_apns_message/main.go
-
Send a message by WebPush. You can set the WebPush attribute for this messaging. File path: examples/send_webpush_message/main.go
-
Send a test message. File path: examples/send_test_message/main.go
You can visit the Reddit community 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, 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 and communicate with other developers.
If you encounter any issues when using the sample code, submit your issues or submit a pull request.
The sample code is licensed under Apache License 2.0.