آموزش ثبت وقایع و logging تراکنش ها در اندروید

کلیه حقوق مادی و معنوی این مقاله متعلق به آموزشگاه تحلیل داده می باشد و هر گونه استفاده غیر قانونی از آن پیگرد قانونی دارد.

در این فصل به مبحث نحوه ی ثبت وقایع (ایجاد و مشاهده ی پیام ها یا گزارشات تراکنش ها /log statement ) در برنامه های کاربردی اندروید پرداخته می شود.

فهرست محتوا

1. ثبت وقایع در اندروید (Logging )

2. ایجاد log statement (نوشتن گزارشات)

3. مشاهده ی log messages (گزارشات در سیستم اندروید)

4. تمرین : بکارگیری log statement

افزودن log statement

استفاده از LogCat view در Android Studio

مشاهده ی LogCat view در محیط برنامه نویسی Eclipse

1. ثبت وقایع در اندروید (Logging)

سیستم اندروید برای کلیه ی گزارشات (log) از یک سیستم مرکزی بهره می گیرد، البته این امکان وجود دارد که شخص برنامه نویس گزارشات اختصاصی (log message custom) بنویسد. تجهیزات برنامه نویسی اندروید به برنامه نویس اجازه می دهد برای گزارشات مورد نظر و دلخواه خود، فیلتر تعریف کند.

2. ایجاد log statement (نوشتن گزارشات)

برای نوشتن و ثبت گزارش از کلاس android.util.Log با متدهای Log.v ()، Log.d ()، Log.i ()، Log.w ()، Log.e () یا Log.wtf () استفاده کنید. متدهای نام برده به ترتیب اهمیت مرتب سازی و سورت می شوند (به طوری که Log.i () در مقایسه با متدهای دیگر از اهمیت کمتری برخوردار است).

اولین پارامتر متدهای بالا رده (category) است و دومین پارامتر خود پیام یا گزارش می باشد.

به طور معمول کاری انجام می دهید، ایجاد رابط Constants در اپلیکیشن اندروید و ارائه ی log flag به عنوان یک فیلد است.

package com.vogella.android.first;
public interface Constants {
String LOG = "com.vogella.android.first";
}

سیستم اندروید توصیه می کند که برنامه ی اجرا شده حاوی کد گزارش نویسی (logging code) نباشد. ابزار برنامه نویسی سیستم اندروید (ADT) پرچم BuildConfig.DEBUG را برای این منظور درنظر گرفته است. چنانچه برنامه نویس اپلیکیشن مورد نظر اندروید را برای توزیع و اجرا صادر (export) کند، پرچم ذکر شده بلافاصله به false تنظیم (set) می شود. این درحالی است که طی فرایند برنامه نویسی پرچم مزبور به true تبدیل یا تنظیم می شود که به شما اجازه می دهد گزارشات (log statement) را مشاهده کنید.

مثال زیر نحوه ی گزارش نویسی پیام خطا را نمایش می دهد.

if (BuildConfig.DEBUG) {
Log.e(Constants.TAG، "onCreate called");
}

3. مشاهده ی log messages (گزارشات در سیستم اندروید)

می توان از طریق LogCat view گزارشات (log statement) اندروید را در محیط Android Studio یا Eclipse ADT مشاهده کرد.

4. تمرین : بکارگیری log statement

افزودن log statement

در پروژه ی com.vogella.android.first، رابط زیر را به منظور تعریف یک ثابت (constant) برای گزارشات (log statement) خود ایجاد کنید.

package com.vogella.android.first;
public interface Constants {
String LOG = "com.vogella.android.first";
}

یک log statement به متد onCreate خود اضافه کنید.

@Override
protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        if (BuildConfig.DEBUG) {
        Log.d(Constants.LOG، "onCreated called");
        }
        setContentView(R.layout.activity_main);
        }