프로젝트 소개

이 패키지는 Electron 데스크톱 애플리케이션에 Aptabase 분석을 통합하기 위한 SDK입니다. Aptabase는 모바일, 데스크톱, 웹 앱을 위한 오픈 소스, 프라이버시 중심, 단순한 분석 플랫폼으로 설명됩니다. 설치는 npm을 통해 수행됩니다: npm add @aptabase/electron 초기화는 Electron main 프로세스에서 app ready 이벤트 전에 발생하며, Aptabase 대시보드에서 받은 App Key를 전달합니다. 이벤트 추적은 renderer 프로세스 이벤트를 위해 @aptabase/electron/renderer에서, main 프로세스 이벤트를 위해 @aptabase/electron/main에서 가져온 trackEvent 함수를 사용합니다. 이벤트는 사용자 정의 속성과 함께하거나 없거나 추적할 수 있으며, 사용자 정의 속성은 문자열 또는 숫자여야 합니다. SDK는 자동으로 OS, 앱 버전 및 기타 유용한 메타데이터로 이벤트를 풍요롭게 합니다. SDK는 이벤트를 자동 추적하지 않으므로, 개발자는 데이터가 캡처되기를 원하는 모든 곳에서 trackEvent를 수동으로 호출해야 합니다. 시작 시 trackEvent를 호출하는 것이 권장됩니다. trackEvent 함수는 배경에서 비동기적으로 실행되며 대기할 필요가 없습니다. AI/LLM 통합 안내를 위해, 저장소는 llms.txt 파일을 참조합니다.