2 unstable releases
0.2.0 | Aug 7, 2024 |
---|---|
0.1.0 | Apr 29, 2024 |
#1197 in Web programming
26 downloads per month
31KB
402 lines
OAuth FCM Library
This library is designed to simplify the process of sending Firebase Cloud Messaging (FCM) messages. It handles the OAuth token for you, ensuring that tokens are refreshed when expired, and provides a simple interface for sending both FCM data and notification messages.
Installation
Add the following to your Cargo.toml
file:
[dependencies]
oauth_fcm = "0.2.0"
Usage
Simple example for axum. More detailed examples for other frameworks can be found in the examples' folder.
use std::fs::File;
use oauth_fcm::{create_shared_token_manager, send_fcm_message, FcmNotification, SharedTokenManager};
#[derive(serde::Serialize)]
struct YourDataType {
// Your data here
key: String,
}
async fn send_notification_route(Extension(token_manager): Extension<SharedTokenManager>, ) {
let data = YourDataType {
key: "value".to_string(),
};
let notification = FcmNotification {
title: "Title".to_string(),
body: "Body".to_string(),
};
send_fcm_message("DEVICE_TOKEN", Some(notification), Some(data), &token_manager, "PROJECT_ID").await.unwrap();
}
#[tokio::main]
async fn main() {
let shared_token_manager =
create_shared_token_manager(File::open("path/to/google/credentials.json")).expect("Could not find credentials.json");
let app = Router::new()
.route("/send", post(send_notification_route))
.layer(Extension(shared_token_manager));
let listener = tokio::net::TcpListener::bind(format!("{}:{}", "127.0.0.1", "8080")).await.unwrap();
axum::serve(listener, app).await.unwrap();
}
Where to get your FCM credentials
- Create a firebase project or use an existing one from the firebase console
- Head to the firebase project settings and select the "Service accounts" tab
- Click on "All service accounts" with the Google cloud icon next to it. You will be redirected to the Google cloud console
- In the cloud console select "Service Accounts" in the drawer menu on the left
- There you select your firebase service account, which is
named:
firebase-adminsdk-xyz@your-project.iam.gserviceaccount.com
- Click on the "keys" tab and create a new key under "add key" in the json format. It will be downloaded
- Now you can use it in your project by providing the file location to your TokenManager from an env file or the file
path:
let shared_token_manager = create_shared_token_manager(File::open("location/your-key-name-xyz.json").unwrap()) .expect("Failed to create SharedTokenManager");
- (Optional) It is better to not keep the file in your version control. Add this to your .gitignore
file:
your-key-name-*.json
Examples
For more detailed examples, please refer to the Examples directory in the repository. There you can find example implementations for either Rocket or Axum. Feel free to open a merge request for any other framework.
Contributing
Please read CONTRIBUTING.md for details on contributing. By contributing, you agree to license your code under the project's license.
License
Licensed under MIT license
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this crate by you, shall be licensed as MIT, without any additional terms or conditions.
Dependencies
~12–28MB
~466K SLoC