Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/aptabase/tauri-plugin-aptabase
Tauri Plugin for Aptabase: Open Source, Privacy-First and Simple Analytics for Mobile, Desktop and Web Apps
https://github.com/aptabase/tauri-plugin-aptabase
analytics aptabase privacy tauri
Last synced: about 2 months ago
JSON representation
Tauri Plugin for Aptabase: Open Source, Privacy-First and Simple Analytics for Mobile, Desktop and Web Apps
- Host: GitHub
- URL: https://github.com/aptabase/tauri-plugin-aptabase
- Owner: aptabase
- License: mit
- Created: 2023-03-23T14:41:14.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-02-05T20:18:04.000Z (8 months ago)
- Last Synced: 2024-04-27T14:31:36.954Z (5 months ago)
- Topics: analytics, aptabase, privacy, tauri
- Language: Rust
- Homepage: https://aptabase.com
- Size: 634 KB
- Stars: 28
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome-tauri - tauri-plugin-aptabase - Privacy-first and minimalist analytics for desktop and mobile apps. (Development / Plugins)
README
# Tauri Plugin for Aptabase
This plugin allows you to instrument your app with events that can be analyzed in Aptabase, an Open Source, Privacy-First, and Simple Analytics for Mobile, Desktop, and Web Apps.
## Install
Install the Core plugin by adding the following to your `Cargo.toml` file:
`src-tauri/Cargo.toml`
```toml
[dependencies]
tauri-plugin-aptabase = "0.4"
```
You can install the JavaScript Guest bindings using your preferred JavaScript package manager
```bash
npm add @aptabase/tauri
```
> This plugin is only compatible with Tauri v1. To use it on a Tauri v2 app, [follow the instructions on our v2 branch](https://github.com/aptabase/tauri-plugin-aptabase/blob/v2).
## Usage
First, you need to get your `App Key` from Aptabase, you can find it in the `Instructions` menu on the left side menu.
Then you need to register the core plugin with Tauri:
`src-tauri/src/main.rs`
```rust
fn main() {
tauri::Builder::default()
.plugin(tauri_plugin_aptabase::Builder::new("").build()) // 👈 this is where you enter your App Key
.run(tauri::generate_context!())
.expect("error while running tauri application");
}
```
You can then start sending events from Rust by importing the `tauri_plugin_aptabase::EventTracker` trait and calling the `track_event` method on `App`, `AppHandle` or `Window`.
As an example, you can add `app_started` and `app_exited` events like this:
```rust
use tauri_plugin_aptabase::EventTracker;
fn main() {
tauri::Builder::default()
.plugin(tauri_plugin_aptabase::init("".into()))
.setup(|app| {
app.track_event("app_started", None);
Ok(())
})
.build(tauri::generate_context!())
.expect("error while running tauri application")
.run(|handler, event| match event {
tauri::RunEvent::Exit { .. } => {
handler.track_event("app_exited", None);
handler.flush_events_blocking();
}
_ => {}
})
}
```
The `trackEvent` function is also available through the JavaScript guest bindings:
```js
import { trackEvent } from "@aptabase/tauri";
trackEvent("save_settings") // An event with no properties
trackEvent("screen_view", { name: "Settings" }) // An event with a custom property
```
A few important notes:
1. The plugin will automatically enhance the event with some useful information, like the OS, the app version, and other things.
2. You're in control of what gets sent to Aptabase. This plugin does not automatically track any events, you need to call `trackEvent` manually.
- Because of this, it's generally recommended to at least track an event at startup
3. You do not need to await for the `trackEvent` function, it'll run in the background.
3. Only strings and numbers values are allowed on custom properties