إنشاء تطبيق بسيط
كيفية استخدام Aspose.Email ل Android عبر Java
سيرشدك هذا الموضوع عبر الخطوات اللازمة لإعداد Aspose.Email ل Android عبر Java في بيئة Android Studio IDE، بافتراض أنك قد قمت بالفعل بتثبيت أحدث نسخة من Android Studio على جهازك وأنك قد حصلت أيضًا على أحدث نسخة من حزمة Aspose.Email ل Android عبر Java.
يمكن تنزيل حزمة Aspose.Email for Android via Java من هنا. يرجى ملاحظة أن كل حزمة إصدار من Aspose.Email for Android via Java تتكون أساساً من ملفين كما هو موضح أدناه.
- aspose-email-x.x.x.jar هو ملف المكتبة الرئيسي الذي يحتوي على جميع المساحات الاسمية من Aspose.Email ل Android عبر Java API.
- aspose-email-x.x.x-libs.apk هو ملف APK يحتوي على bcprov-jdk15-146.jar من طرف ثالث يُستخدم لتوفير ميزات التشفير وفك التشفير التي يقدمها Aspose.Email ل Android عبر Java API.
بدء الاستخدام مع Aspose.Email for Android via Java في Android Studio
بعد تحميل بيئة Android Studio، انقر على File > New > New Project كما هو موضح أدناه.

يمكنك أيضاً إنشاء مشروع جديد من شاشة الترحيب في Android Studio كما هو موضح أدناه.

بعد ذلك، ستظهر لك نافذة لتحديد اسم التطبيق والنطاق والموقع لتخزين ملفات المشروع. يمكنك تعديل القيم الافتراضية حسب رغبتك أو تركها كما هي، ثم انقر على Next.

في الخطوة التالية، عليك تحديد جهاز Android الذي تريد تشغيل تطبيقك عليه. بعد الاختيار، انقر على زر Next.

الآن تحتاج إلى اختيار الـ Activity من قائمة القوالب المحددة مسبقاً. لتبسيط الشرح، اخترنا قالب Empty Activity كما هو موضح أدناه.

انقر على زر Finish في مربع الحوار Customize the Activity مع الحفاظ على جميع الإعدادات الافتراضية كما هي.

بمجرد النقر على زر Finish في الخطوة السابقة، سيبدأ IDE في بناء المشروع كما هو موضح أدناه. انتظر حتى يكتمل أو انقر على زر Cancel.

الآن تم تحميل المشروع في بيئة التطوير المتكاملة، ومع ذلك قد ترغب في تغيير العرض إلى Project لتتمكن من مشاهدة هيكلية ملفات المشروع بالكامل. لتغيير العرض، يرجى مراجعة اللقطة التالية.

بعد تغيير العرض إلى Project، ابحث عن ملف build.gradle وحمّله في المحرر والصق المقتطف التالي كما هو موضح أدناه.
dexOptions{
javaMaxHeapSize "4g"
}

بعد ذلك، سنضيف ملف Aspose.Email for Android via Java Jar إلى المشروع. هناك خطوةان مهمتان كما هو موضح أدناه.
- انسخ ملف Aspose.Email for Android via Java Jar يدوياً إلى المجلد \app\libs.
- أضف ملف Aspose.Email for Android via Java Jar كمكتبة إلى الوحدة كما هو موضح أدناه.

ستظهر لك نافذة لتحديد الوحدة التي ترغب في إضافة ملف Aspose.Email for Java.Android Jar كمكتبة إليها. يرجى الاختيار المناسب ثم النقر على OK.

تحتاج أيضاً إلى إضافة ملف APK إلى المشروع. عليك نسخ ملف APK إلى المجلد \app\src\main\assets. إذا لم يكن لديك مجلد assets تحت المجلد الرئيسي، يمكنك إنشاء واحد بالنقر بزر الماوس الأيمن على العقدة الرئيسية في عرض المشروع. اختر New > Folder > Asset Folder.

بعد إضافة ملف APK إلى المشروع، يجب تحميله من قبل المشروع. هناك طريقتان لتحميل ملف APK كما يلي.
- حمّل ملف APK في فئة تطبيق مخصصة باستخدام المقتطف المذكور أدناه، وسجِّل فئة التطبيق المخصصة في ملف AndroidManifest.xml.
LibsLoadHelper.loadLibs(this);
- حمّل ملف APK في طريقة OnCreate داخل MainActivity.
LibsLoadHelper.loadLibs(getApplicationContext());
الآن نحن مستعدون لكتابة الشيفرة. لتبسيط الشرح وجعله سهل الفهم، أضفنا عنصر زر (Button) إلى التخطيط وسنتعامل مع حدث النقر كالتالي.
private class TestEmail extends AsyncTask<Void, String, Boolean>
{
@Override
protected Boolean doInBackground(Void... params)
{
Boolean result = false;
try
{
//Create an instance of PersonalStorage
com.aspose.email.PersonalStorage pst = com.aspose.email.PersonalStorage.create("newSample_out.pst", 0);
//Create a folder at root of PST
pst.getRootFolder().addSubFolder("myInbox");
//Add message to newly created folder
pst.getRootFolder().getSubFolder("myInbox").addMessage(com.aspose.email.MapiMessage.fromFile("message.msg"));
}
catch (Exception e)
{
e.printStackTrace();
}
return result;
}
}
عند تشغيل التطبيق باستخدام زر التشغيل في واجهة IDE (أو باستخدام SHIFT + F10) سيقوم المحاكي بتحميل التطبيق كما هو موضح أدناه.

النقر على الزر في المحاكي سيؤدي إلى تنفيذ الشيفرة.