دليل React Native مع AllStak

التثبيت

ثبّت من npm.

npm install @allstak/react-native

الإعداد

هيّئ وغلّف مكوّن App الجذري.

import * as AllStak from '@allstak/react-native';
import App from './App';

AllStak.init({
  apiKey: process.env.EXPO_PUBLIC_ALLSTAK_API_KEY,
  environment: process.env.NODE_ENV ?? 'production',
  release: process.env.EXPO_PUBLIC_RELEASE,
  tracesSampleRate: 1.0,
  enableLogs: true,
});

export default AllStak.wrap(App);

مثال أساسي

بدلًا من ذلك، غلّف الشجرة بـ AllStakProvider.

import { AllStakProvider } from '@allstak/react-native';

export default function Root() {
  return (
    <AllStakProvider
      apiKey={process.env.EXPO_PUBLIC_ALLSTAK_API_KEY}
      environment="production"
      release={process.env.EXPO_PUBLIC_RELEASE}
    >
      <App />
    </AllStakProvider>
  );
}

التقاط الأخطاء

التقط الاستثناءات المُعالَجة والرسائل.

AllStak.captureException(new Error('checkout failed'));
AllStak.captureMessage('cart opened', 'info');

تتبّع الطلبات

تُجهَّز fetch و XMLHttpRequest و axios تلقائيًا (enableHttpTracking، مفعّل افتراضيًا)؛ ويضبط httpTracking التنقية. ولا يوثّق README نداء HTTP يدويًا — بالإعداد فقط.

أفضل الممارسات

• صدّر AllStak.wrap(App) لتُلتقط أعطال النظام الأصلية.
• وفّر المفتاح عبر EXPO_PUBLIC_ALLSTAK_API_KEY.
• اضبط release لتتبّع الجلسات الخالية من الأعطال لكل نسخة.