Android

‫‪Android‬‬
‫تعلم برمجة تطبيقات االندرويد من الصفر الى االحتراف‬
‫‪Ahmed Ibrahim‬‬ ‫‪9/7/17‬‬ ‫‪Basrah - Iraq‬‬

‫فهرس المحتويات‬
‫الفصل االول (االساسيات ومصادر البيانات ‪5........................................................... )Resources‬‬
‫الملف الرئيسي ‪5............................................................................................... manifest‬‬
‫المف ‪7................................................................................................................. style‬‬
‫الملف النصي ‪7............................................................................................. strings.xml‬‬
‫مصادر البيانات ‪9........................................................................................... Resources‬‬
‫شروط تسمية المجلدات ‪9.................................................................................................‬‬
‫عمل طبقة افقية ‪10........................................................................................................‬‬
‫الكالس ‪12.............................................................................................................. Log‬‬
‫الدالة ‪13.................................................................................................................. d‬‬
‫الدالة ‪13................................................................................................................... i‬‬
‫الكالس ‪14........................................................................................................Handler‬‬
‫الدالة ‪14............................................................................................................. post‬‬
‫الدالة ‪14................................................................................................ postDelayed‬‬
‫ادارة الـ ‪ Widgets‬من داخل ملف ‪17............................................................................ Java‬‬
‫الفصل الثاني (دورة الحياة والمحافظة على البيانات) ‪20.................................................................‬‬
‫الدالة ‪22........................................................................................................ onRestart‬‬
‫حفظ واستعادة البيانات ‪22...................................................................................................‬‬
‫الدالة ‪23...................................................................................... onSaveInstanceState‬‬
‫الدالة ‪24..................................................................................onRestoreInstanceState‬‬
‫الفصل الثالث (أكثر من ‪25..................................................................................... )Activity‬‬
‫انشاء ‪ Activity‬جديدة ‪25..................................................................................................‬‬
‫الوصول الى ‪ Activity‬من ‪ Activity‬اخرى ‪26.....................................................................‬‬
‫تمرير البيانات بين الـ ‪28................................................................................... Activities‬‬
‫المرحلة االولى االرسال‪28.............................................................................................:‬‬
‫المرحلة الثانية االستالم‪28..............................................................................................:‬‬
‫الدالة ) (‪29.................................................................................................. getIntent‬‬
‫‪0‬‬
29.............................................................................. ‫ االبن‬Activity ‫استعادة نتائج من الـ‬
30......................................................................................... onActivityResult ‫الدالة‬
33.......................................................................)List views and Adapters( ‫الفصل الرابع‬
35.............................................................................................................list activity
36.......................................................................................... ListActivity ‫دوال الكالس‬
36................................................................................................ getListView ‫الدالة‬
36...................... onListItemClick (ListView l, View v, int position, long id) ‫الدالة‬
37.............................................................................. setListAdapter(adapter) ‫الدالة‬
37................................................................................................................ Adapters
37.............................................................................................. ArrayAdapter ‫الكالس‬
38................................................................................................... setAdapter ‫الدالة‬
39..................................................................................................... ArrayList ‫الكالس‬
40.......................................................................................... )Fragments( ‫الفصل الخامس‬
40............................................................................................... fragment ‫دورة حياة الـ‬
41........................................................................................................Fragment ‫انشاء‬
41................................................................................................. Fragment ‫مكونات الـ‬
42........................................................................... fragment ‫ الذي يعرض الـ‬activity ‫الـ‬
44...................................................... fragment ‫ من داخل الـ‬Widgets ‫الوصول الى العناصر‬
46...................................................................... ‫ على شكل قائمة عرض‬Fragment ‫تنظيم الـ‬
47........................................................................................ ListFragment ‫دوال الكالس‬
47................................................................................................ getListView ‫الدالة‬
47...................... onListItemClick (ListView l, View v, int position, long id) ‫الدالة‬
48.............................................................................. setListAdapter(adapter) ‫الدالة‬
49............................................................................ ‫ اخر‬Fragment ‫ بـ‬Fragment ‫استبدال‬
51..............................................................................‫ المعروضة حاليا‬Fragment ‫معرفة الـ‬
52......................................................................... Fragment ‫التعامل مع زر الرجوع في الـ‬
52..................................................................................................... ‫ متداخلة‬Fragment
1
‫مالحظات عامة عن الـ ‪53.................................................................................. Fragment‬‬
‫الفصل السادس (‪54.......................................................................................... )action bars‬‬
‫الملف ‪55............................................................................................................. menu‬‬
‫اضافة زر في الـ ‪56......................................................................................... action bar‬‬
‫الخطوة االولى ‪56.........................................................................................................‬‬
‫الخطوة الثانية ‪57..........................................................................................................‬‬
‫عمل زر مشاركة في الـ ‪58................................................................................ action bar‬‬
‫اضافة زر رجوع في الـ ‪60................................................................................ action bar‬‬
‫تغييير عناصر الـ ‪ action bar‬اثناء تشغيل البرنامج ‪62..............................................................‬‬
‫مالحظات عامة عن الـ ‪62................................................................................. action bar‬‬
‫الفصل السابع (القائمة الجانبية ‪63............................................................ )Navigation drawer‬‬
‫الفصل الثامن (قواعد البيانات ‪77............................................................................... )SQLite‬‬
‫الجزء االول ‪80...............................................................................................................‬‬
‫الكالس ‪81....................................................................................... SQLiteDatabase‬‬
‫التعديل على جدول ‪84........................................................................................SQLite‬‬
‫عمل تحديث للبيانات ‪85..................................................................................................‬‬
‫الجزء الثاني ‪86...............................................................................................................‬‬
‫الدالة ‪87........................................................................................................... query‬‬
‫استخدام دوال ‪ SQL‬مع الدالة ‪89............................................................................ query‬‬
‫الدالة ‪ getReadableDatabase‬والدالة ‪91...................................... getWritableDatabase‬‬
‫دوال التنقل ‪92..............................................................................................................‬‬
‫اخذ البيانات من االوبجكت ‪93............................................................................... Cursor‬‬
‫اغالق االوبجكت ‪ Cursor‬وقاعدة البيانات ‪94.......................................................................‬‬
‫‪95................................................................................................... CursorAdapter‬‬
‫‪95........................................................................................ SimpleCursorAdapter‬‬
‫اضافة قيم في قاعدة البيانات ‪97.........................................................................................‬‬
‫الدالة ‪98.............................................................................................. changeCursor‬‬
‫‪2‬‬
‫زيادة سرعة قواعد البيانات ‪98.............................................................................................‬‬
‫الكالس ‪99............................................................................................... AsyncTask‬‬
‫الفصل التاسع (‪102............................................................... )Notifications and messages‬‬
‫االشعارات ‪102......................................................................................... Notifications‬‬
‫النوافذ المنبثفة (‪109........................................................................................ )Messages‬‬
‫النافذة المنبثقة ‪109...............................................................................................Toast‬‬
‫مربع حوار ‪110............................................................................................... Dialog‬‬
‫رسالة التنبيه ‪113................................................................................................. Alert‬‬
‫الفصل العاشر (‪117............................................................................................. )Services‬‬
‫الجزء االول (‪118.................................................................................. )started service‬‬
‫الجزء الثاني (‪121................................................................................... )bound service‬‬
‫الموقع ‪124.................................................................................................. Location‬‬
‫الفصل الحادي عشر (‪126...................................................................................... )Sensors‬‬
‫الفصل الثاني عشر (‪135........................................................................ )Bluetooth & Wifi‬‬
‫‪135..................................................................................................... The Bluetooth‬‬
‫‪152............................................................................................................ The Wi-Fi‬‬
‫الفصل الثالث عشر (تحويل النص الى كالم) ‪169.........................................................................‬‬
‫الفصل الرابع عشر (‪175.......................................................................... )Material Design‬‬
‫انشاء ‪175............................................................................................... Recyclerview‬‬
‫الفصل االخير (مالحظات عامة) ‪184.......................................................................................‬‬
‫‪3‬‬
‫*****‬
‫هذا الكتاب من اعداد احمد ابراهيم‪ ،‬وهناك كتب اخرى كتبها الكاتب لتعلم لغات برمجة مختلفة منها‬
‫(‪ )HTML CSS, JavaScript, jQuery, PHP, Java‬يمكنكم تحميلها وقراءتها من هذا الرابط‪:‬‬
‫‪https://drive.google.com/open?id=0B2aI_a6mphOUQi1jdzlYSFhITWs‬‬
‫كل هذه الكتب مجانية اي يمكن قراءتها واعادة نشرها‪.‬‬
‫الي سؤال او استفسار يمكنكم التواصل مع الكاتب عبر الحساب الشخصي في فيسبوك‪:‬‬
‫‪https://www.facebook.com/ah.ib.93‬‬
‫‪4‬‬
‫الفصل االول (االساسيات ومصادر البيانات ‪)Resources‬‬
‫كل شاشة ‪ activity‬تعرض للمستخدم هي متكونة من ملفين االول يمثل الجزء الظاهر على الشاشة وهو‬
‫مكتوب بلغة ‪ XML‬ويسمى ‪ layout‬اما الثاني فهو مكتوب بلغة ‪ Java‬وهو يدير الجزء االول‪.‬‬
‫‪ Widgets‬هي عبارة عن كالسات وكل كالس من هذه الكالسات هو عبارة عن عنصر يعرض للمستخدم‬
‫مثال الزر ‪ button‬او حقل اظهار النص ‪ TextView‬كلها عبارة عن ‪.Widgets‬‬
‫كل ‪ Widget‬هو عبارة عن كالس مشتق من الكالس ‪ View‬او مشتق من كالس مشتق من الكالس ‪.View‬‬
‫كل عنصر من العناصر ‪ Widgets‬له عدة خصائص مثل الطول والعرض والنص الذي يظهر والـ ‪ id‬الخ‬
‫من الخصائص كلها تكون في ملف الـ ‪ XML‬الذي يعرض الطبقة ‪ ،layout‬وكل هذه الخصائص يمكن‬
‫التعامل معها بشكل سهل من خالل قسم الـ ‪ Design‬في برنامج االندرويد ستوديو او كتابتها بشكل يدوي في‬
‫قسم الـ ‪.Text‬‬
‫* الدالة ‪ setContentView‬وظيفتها هي ان تعرض ملف الـ ‪ layout‬على الشاشة ويمرر لها باراميتر يمثل‬
‫اسم ومسار الـ ‪ layout‬المراد عرضها‪ ،‬مثال‪:‬‬
‫;)‪setContentView(R.layout.activity_main‬‬
‫حيث ان ‪ R‬يمثل اسم المجلد االفتراضي الذي توضع فيه الـ ‪ layout‬والذي اسمه ‪ res‬و‪ layout‬يمثل اسم‬
‫المجلد الفرعي الذي بداخله و‪ activity_main‬هو اسم ملف الـ ‪ layout‬الذي سيعرض للمستخدم‪.‬‬
‫الملف الرئيسي ‪manifest‬‬

‫هو ملف مكتوب بلغة ‪ XML‬ويعتبر الملف الرئيسي في اي برنامج النه من خالله يستطيع االندرويد ‪ OS‬ان‬
‫يتعرف على البرنامج فهو يحتوي على المعلومات االساسية‪ ،‬فهو يحتوي على اسم البرنامج واسم ملف الجافا‬
‫الرئيسي الذي سيبدأ منه تنفيذ البرنامج باالضافة الى اسم اي ‪ activity‬يتم انشائه باالضافة الى تفاصيل‬
‫اخرى‪ ،‬يوجد هذا الملف في الـ ‪ Project‬في المجلد ‪ manifests <- app‬واسم الملف هو‬
‫‪ ، AndroidManifest.xml‬ويكون الكود الموجود بداخله بهذا الشكل‪:‬‬
‫>?"‪<?xml version="1.0" encoding="utf-8‬‬

‫"‪<manifest xmlns:android="http://schemas.android.com/apk/res/android‬‬
‫‪5‬‬
‫>"‪package="com.bignerdranch.android.myapplication‬‬
‫‪<application‬‬
‫"‪android:allowBackup="true‬‬
‫"‪android:icon="@mipmap/ic_launcher‬‬
‫"‪android:label="@string/app_name‬‬
‫"‪android:roundIcon="@mipmap/ic_launcher_round‬‬
‫"‪android:supportsRtl="true‬‬
‫>"‪android:theme="@style/AppTheme‬‬
‫‪<activity‬‬
‫"‪android:name=".MainActivity‬‬
‫> ‪android:label="@string/activity_name‬‬
‫…‬
‫>‪</activity‬‬
‫>‪</application‬‬
‫>‪</manifest‬‬
‫حيث ان الوسم >‪ <application‬يمثل كامل البرنامج والوسم >‪ <activity‬يمثل الـ ‪ activity‬وكل‬
‫‪ activity‬جديدة ننشأها يجب ان يتم ذكرها هنا (البرنامج يقوم بذلك اوتوماتيكيا)‪ ،‬وهناك مجموعه من‬
‫الخصائص مثال‪:‬‬
‫الخاصية ‪ android:icon‬تستخدم لتحديد ايقونة للبرنامج‪ ،‬واذا استخدمنا ثيم يعرض ايقونة في الـ ‪action‬‬
‫‪ bar‬فانه سيتم عرض هذه االيقونة‪ ،‬االيقونة يمكن ان تكون في المجلد ‪ mipmap‬او في المجلد ‪drawable‬‬
‫والفرق هو ان في المجلد ‪ mipmap‬ستكون ايقونة واحدة تعرض لجميع االجهزة اما في المجلد ‪drawable‬‬
‫يمكن ان نضع مجموعة من االيقونات كل ايقونة تعرض في جهاز على حسب دقة الشاشة‪ ،‬وهنا اشرنا الى‬
‫المجلد ‪ mipmap‬من خالل اضافة @ قبل اسمه ‪.‬‬
‫الخاصية ‪ android:label‬تمثل اسم البرنامج اذا كانت في الوسم >‪ <application‬او تمثل اسم الـ‬
‫‪ activity‬اذا كانت في الوسم >‪ <activity‬واالسم موجود في الملف النصي ‪. string‬‬
‫الخاصية ‪ android:theme‬تحدد الثيم‪ ،‬استخدامها في الوسم >‪ <application‬يجعل الثيم مطبق على كامل‬
‫البرنامج اما اذا كانت في الوسم >‪ <activity‬فتطبق على الـ ‪ activity‬فقط ‪ ،‬والثيم موجود في الملف ‪style‬‬
‫‪.‬‬
‫‪6‬‬
‫المف ‪style‬‬
‫هذا الملف يحمل التفاصيل الي ثيم نريد ان نستخدمه‪ ،‬عندما ننشأ مشروع جديد في برنامج االندرويد‬
‫ستوديو فان الـ ‪ IDE‬ينشأ ملف باسم ‪ style.xml‬ويضعه في المجلد‪:‬‬
‫‪app-> res->values‬‬
‫والكود في هذا الملف بشكل افتراضي ينشأ بهذا الشكل‪:‬‬
‫>‪<resources‬‬
‫>‪
<TextView
id"
android:id="@+id/label"
android:layout_height="match_parent"
android:padding="10dip"
android:textSize="16sp"
android:textStyle="bold"
android:textColor="@android:color/holo_blue_dark">
</TextView>
4- connect.xml
<RelativeLayout
id"
160
<TextView
android:id="@+id/textSSID1"
android:layout_height="wrap_content" />
<EditText
android:id="@+id/textPassword"
android:layout_below="@id/textSSID1"
android:layout_marginTop="5dp"/>
<Button
android:id="@+id/okButton"
android:layout_below="@id/textPassword"
android:text="Connect"/>
</RelativeLayout>
5- AndroidManifest.xml
<manifest
id"
package="com.example.ahmed.myapplication">
<uses-permission
android:name="android.permission.ACCESS_WIFI_STATE"/>
<uses-permission
android:name="android.permission.ACCESS_NETWORK_STATE"/
>
<uses-permission
android:name="android.permission.CHANGE_WIFI_STATE"/>
<uses-permission
android:name="android.permission.ACCESS_COARSE_LOCATION
" />
<uses-permission
161
android:name="android.permission.ACCESS_FINE_LOCATION"
/>
<application
android:allowBackup="true"
android:icon="@mipmap/ic_launcher"
android:label="@string/app_name"
android:roundIcon="@mipmap/ic_launcher_round"
android:supportsRtl="true"
android:theme="@style/AppTheme">
<activity android:name=".MainActivity">
<intent-filter>
<action
android:name="android.intent.action.MAIN" />
<category
android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
</application>
</manifest>
Wi-Fi Direct
،‫يستخدم هذا النوع من االتصال لالتصال بين جهازين لنقل البيانات مباشرتا دون الحاجة الى شبكة خارجية‬
‫ وهذا الكالس مسؤال عن االتصال واكتشاف‬WifiP2pManager ‫ولعمل ذلك نحتاج الى استخدام الكالس‬
:‫ وللتعامل مع هذا الكالس علينا اخذ االذونات التالية‬،‫األجهزة األخرى‬
<uses-permission android:name=”android.permission.ACCESS_WIFI_STATE”/>
<uses-permission
android:name=”android.permission.CHANGE_WIFI_STATE”/>
<uses-permission android:name=”android.permission.INTERNET”/>
162
‫ ونمرر لها بين قوسيها القيمة التالية‬getSystemService ‫وللوصول الى هذا الكالس نستخدم الدالة‬
:‫ بهذا الشكل‬،Context.WIFI_P2P_SERVICE
WifiP2pManager wifiP2p =
(WifiP2pManager)getSystemService(Context.WIFI_P2P_SERVICE);
:‫هذا الكالس يحتوي على مجموعة من الدوال من أهمها‬
initialize
‫ وهي تستدعى قبل أي دالة من دوال الكالس‬Wi-Fi ‫تستخدم هذه الدالة لتهيئة التطبيق في إطار شبكة الـ‬
:‫ مثال‬،‫ وبعدها ننشأ قناة لالصغاء الى االتصال‬WifiP2pManager
private WifiP2pManager wifiP2pManager;
private WifiP2pManager.Channel wifiDirectChannel;
private void initializeWiFiDirect() {
wifiP2pManager =
(WifiP2pManager)getSystemService(Context.WIFI_P2P_SERVI
CE);
wifiDirectChannel = wifiP2pManager.initialize(this,
getMainLooper(), new WifiP2pManager.ChannelListener() {
public void onChannelDisconnected() {
initializeWiFiDirect();
}
});
}
connect
‫ مع جهاز محدد‬Wi-Fi ‫تستخدم هذا الدالة لالتصل عبر الـ‬
discoverPeers
‫ الموجودة في نطاق البحث‬Wi-Fi ‫تستخدم هذه الدالة الكتشاف كل أجهزة الـ‬
163
‫‪cancelConnect‬‬
‫هذه الدالة تستخدم اللغاء االتصال باي جهاز ‪ Wi-Fi‬اخر‬
‫‪removeGroup‬‬
‫هذه الدالة تستخدم اللغاء االتصال الحالي بين الجهازين المتصلين‬
‫مثال متكامل‪:‬‬
‫هذا المثال يرسل نص الى ‪ esp8266‬لتعرضها هي على شاشة الـ ‪ Serial Monitor‬وهي بدورها تعيد‬
‫نص الى البرنامج ليستلمه ويعرضه البرنامج (برنامج الـ ‪ esp8266‬موجود في كتاب االردوينو الذي كتبته‬
‫انا)‪ ،‬بهذا الشكل‪:‬‬
‫‪1- MainActivity.java‬‬
‫‪164‬‬
import java.io.DataInputStream;
import java.io.DataOutputStream;
import java.io.IOException;
import java.net.Socket;
import android.annotation.SuppressLint;
import android.os.AsyncTask;
import android.view.View.OnClickListener;
TextView textResponse;
Button buttonConnect;
EditText welcomeMsg;
String IpAddress = "192.168.0.117";
int Port = 8090;
@Override
buttonConnect = (Button)
findViewById(R.id.connect);
textResponse = (TextView)
findViewById(R.id.response);
welcomeMsg =
(EditText)findViewById(R.id.welcomemsg);
buttonConnect.setOnClickListener(new
OnClickListener() {
@Override
165
MyClientTask myClientTask = new
MyClientTask(welcomeMsg.getText().toString());
myClientTask.execute();
}
});
}
@SuppressLint("StaticFieldLeak")
public class MyClientTask extends AsyncTask<Void, Void,
Void> {
String response = "";
String msgToServer;
MyClientTask(String msgTo) {
msgToServer = msgTo;
}
@Override
protected Void doInBackground(Void... arg0) {
Socket socket = null;
DataOutputStream dataOutputStream = null;
DataInputStream dataInputStream = null;
try {
socket = new Socket(IpAddress, Port);
dataOutputStream = new
DataOutputStream(socket.getOutputStream());
dataInputStream = new
DataInputStream(socket.getInputStream());
if(!msgToServer.equals(""))
dataOutputStream.writeUTF(msgToServer+"$");
int x = dataInputStream.read();
while (x>0) {
response += Character.toString ((char)
x);
x = dataInputStream.read();
}
166
} catch (IOException e) { }
finally {
if (socket != null) {
try {
socket.close();
}
if (dataOutputStream != null) {
try {
dataOutputStream.close();
}
if (dataInputStream != null) {
try {
dataInputStream.close();
}
}
return null;
}
@Override
protected void onPostExecute(Void result) {
textResponse.setText(response);
super.onPostExecute(result);
}
}
}
2- activity_main.xml
<LinearLayout
id"
xmlns:tools="http://schemas.android.com/tools"
android:layout_height="match_parent"
tools:context=".MainActivity" >
167
<EditText
android:id="@+id/welcomemsg"
android:hint="Say hello to server" />
<Button
android:id="@+id/connect"
android:text="Connect..."/>
<TextView
android:id="@+id/response"
android:layout_height="wrap_content"/>
</LinearLayout>
manifest ‫وال تنسى وضع التصريح التالي في ملف الـ‬ •
<uses-permission
android:name="android.permission.INTERNET" />
:2 ‫مثال متكامل‬
‫هذا المثال هو عبارة عن برنامجين على جهازين اندرويد الرسال واستقبال البيانات حيث ان أحدهم يعمل‬
:‫ تجد المثال على هذا الرابط‬،‫كخادم واألخر يعمل كعميل‬
http://android-er.blogspot.com/2014/08/bi-directional-communication-
between.html
168
‫الفصل الثالث عشر (تحويل النص الى كالم)‬
‫في هذا الفصل سنتعلم كيف نحول النص الى كالم مسموع باستخدام محرك االندرويد ‪ TTS‬وهو اختصار‬
‫لكلمة ‪ ،Text to speech‬لكي نفهم االمر بشكل واضح سنقوم بعمل برنامج بسيط يحتوي ‪ activity‬واحدة‬
‫تعرض حقل نصي من النوع ‪ EditText‬يكتب فيه المستخدم النص المراد نطقه‪ ،‬ونعمل زر ‪ Button‬عند‬
‫الضغط عليه سيتحدث البرنامج‪ ،‬وسنقسم تصميم البرنامج الى عدة خطوات وفي األخير سأكتب كامل كود‬
‫البرنامج‪.‬‬
‫الخطوة األولى‪:‬‬
‫سنعمل الطبقة ‪ layout‬ونضع فيها حقل نصي ‪ EditText‬ونعطيه ‪ id‬باالسم ‪ ،enter‬وكذلك سنعمل زر‬
‫‪ Button‬نعطيه ‪ id‬باالسم ‪ ،speak‬عند الضغط على هذا الزر سيتم تنفيذ الدالة المسماة ‪ Speack_fun‬لذا‬
‫نضع اسمها في الخاصية ‪ onClick‬للزر‪ ،‬وبهذا نكون قد انتهينا من الطبقة ‪ layout‬وباقي عملنا سيكون على‬
‫كالس الجافا‪.‬‬
‫الخطوة الثانية‪:‬‬
‫‪169‬‬
‫ هذا االنترفيس‬،OnInitListener ‫ لالنترفيس‬implements ‫ أوال نجعله يعمل‬،‫نأتي االن الى كالس الجافا‬
.‫ لكن سنتكلم عنها في الخطوة الخامسة‬onInit ‫يتطلب منا ان نعمل دالته‬
‫ بهذا‬،myTTS ‫ وسنسميه‬TextToSpeech ‫ نقوم بتعريف اوبجكت من النوع‬onCreate ‫في خارج الدالة‬

:‫الشكل‬
private TextToSpeech myTTS;
‫ واال فلن يعمل برنامجنا لذا علينا‬TTS ‫في البداية علينا ان نتأكد من ان جهاز المستخدم فيه هذا المحرك‬
‫ (شرحنا عن هذه الدالة في‬startActivityForResult ‫ وارساله بالدالة‬intent ‫االستعالم من خالل انشاء‬
)onCreate ‫ (هذا الكود يكتب في داخل الدالة‬:‫ بهذا الشكل‬،)‫الفصل الثالث‬
Intent checkTTSIntent = new Intent();

checkTTSIntent.setAction(TextToSpeech.Engine.ACTION_CHECK_TTS_DATA
);
startActivityForResult(checkTTSIntent, MY_DATA_CHECK_CODE);
‫ يمثل رقم االستعالم ونعرفه‬int ‫ هو عبارة عن متغير من النوع‬MY_DATA_CHECK_CODE

:‫ بهذا الشكل‬onCreate ‫خارج الدالة‬
private int MY_DATA_CHECK_CODE = 0;
.)‫ (شرحنا عنها في الفصل الثالث‬onActivityResult ‫وسنستلم نتيجة االستعالم من خالل الدالة‬
:‫الخطوة الثالثة‬
‫ بهذا‬،‫ وفي داخل الكالس الرئيسي‬onCreate ‫ في أي مكان خارج الدالة‬onActivityResult ‫ننشأ الدالة‬
:‫الشكل‬
@Override
if (requestCode == MY_DATA_CHECK_CODE) {
if (resultCode == TextToSpeech.Engine.CHECK_VOICE_DATA_PASS) {
myTTS = new TextToSpeech(this, this);
} else {
Intent installTTSIntent = new Intent( );
170
‫‪installTTSIntent.setAction(TextToSpeech.Engine.ACTION_INSTALL_TTS_DAT‬‬
‫;)‪A‬‬
‫;)‪startActivity(installTTSIntent‬‬
‫}‬
‫}}‬
‫الشرط األول ‪ requestCode == MY_DATA_CHECK_CODE‬عملناه لنتأكد من ان نتيجة الطلب‬

‫جائت عن هذا االستعالم وليس غيره (شرحنا عنه في الفصل الثالث) وفي داخل هذا الشرط سنكتب كل الكود‬
‫المطلوب‪ ،‬الشرط الثاني نضعه لنتأكد من ان جهاز المستخدم يحتوي على البيانات المطلوبة للنطق‪ ،‬فاذا كان‬
‫يحتوي ننشأ االوبجكت ‪ myTTS‬الذي عملناه بالخطوة الثانية‪ ،‬اما إذا لم يكن يحتوي جهاز المستخدم على‬
‫البيانات المطلوبة سننفذ ما بداخل الـ ‪ else‬وهنا كتبنا كود لنرشد المستخدم لكي يسطب هذه البيانات على‬
‫جهازة‪.‬‬
‫الخطوة الرابعة‪:‬‬
‫االن سنقوم بانشاء الدالة ‪ Speack_fun‬والتي قلنا انه سيتم تنفيذها عند الضغط على الزر ‪ ،Button‬سنكتبها‬
‫{ )‪public void Speack_fun(View v‬‬

‫;)‪EditText enteredText = (EditText)findViewById(R.id.enter‬‬
‫;)(‪String words = enteredText.getText().toString‬‬
‫;)‪speakWords(words‬‬
‫}‬
‫حيث هنا سنقوم باخذ النص المكتوب في الحقل النصي ‪ EditText‬ونضعه في المتغير ‪( words‬الحظ‬
‫استخدام الدالة ‪ toString‬معه) وبعدها سنمرر هذه القيمة الى الدالة ‪ speakWords‬والتي سننشأها في‬
‫الخطوة السادسة‪.‬‬
‫الخطوة الخامسة‪:‬‬
‫قلنا في الخطوة الثانية انه علينا ان نعمل ‪ implements‬لالنترفيس ‪ ،OnInitListener‬وهذا االنترفيس‬
‫يتطلب منا ان نعمل دالته ‪ ،onInit‬االن سنتكلم عن كيفية انشاء هذه الدالة‪ ،‬بهذا الشكل‪:‬‬
‫{ )‪public void onInit(int initStatus‬‬
‫‪171‬‬
‫{ )‪if (initStatus == TextToSpeech.SUCCESS‬‬
‫‪if(myTTS.isLanguageAvailable(Locale.US)==TextToSpeech.LANG_AVAI‬‬
‫)‪LABLE‬‬
‫;)‪myTTS.setLanguage(Locale.US‬‬
‫{ )‪} else if (initStatus == TextToSpeech.ERROR‬‬
‫;)(‪Toast.makeText(this, "Sorry! failed...", Toast.LENGTH_LONG).show‬‬
‫}}‬
‫في الشرط األول ‪ initStatus == TextToSpeech.SUCCESS‬نتأكد من ان العملية ناجحة وبخالف‬

‫ذلك ن ظهر رسالة تنبيه للمستخدم‪ ،‬اما اذا كانت ناجحة فعلينا ان نحدد اللغة التي سيتكلم بها الجهاز‪ ،‬مثال هنا‬
‫جعلناه يتكلم باللغة اإلنجليزية االمريكية باستخدام الدالة ‪( setLanguage‬يمكن اختيار لغات أخرى) وهذه‬
‫الدالة وضعناها في داخل الشرط حيث ان هذا الشرط يتأكد من ان هذه اللغة بالتحديد موجودة في جهاز‬
‫المستخدم‪.‬‬
‫الخطوة السادسة‪:‬‬
‫ننشأ الدالة ‪ speakWords‬والتي كنا قد استدعيناها من داخل الدالة ‪ Speack_fun‬في الخطوة الرابعة‬
‫ونكتبها بهذا الشكل‪:‬‬
‫{ )‪private void speakWords(String words‬‬

‫;)‪myTTS.speak(words, TextToSpeech.QUEUE_FLUSH, null‬‬
‫}‬
‫هذا االمر سيجعل البرنامج ينطق الكالم الممرر له هنا باالسم ‪words‬‬
‫الخطوة السابعة‪:‬‬
‫يمكن ان نضيف العديد من الخيارات والخصائص األخرى على دوال النطق‪ ،‬مثال يمكن ان نضيف الدالة‬
‫‪ shutdown‬او الدالة ‪ stop‬والتي نعني بها ان يتوقف عن النطق‪.‬‬
‫;) (‪myTTS.shutdown‬‬
‫;) (‪myTTS.stop‬‬
‫‪172‬‬
‫ (هذا هو ملف الجافا في الـ‬:‫االن سنكتب كامل الكود الذي شرحناه في الخطوات السابقة ليكون بهذا الشكل‬
)activity
import android.speech.tts.TextToSpeech;
import android.speech.tts.TextToSpeech.OnInitListener;
import java.util.Locale;
public class MainActivity extends Activity implements OnInitListener {
//TTS object
private TextToSpeech myTTS;
//status check code
private int MY_DATA_CHECK_CODE = 0;
//create the Activity
@Override
public void onCreate(Bundle savedInstanceState) {
//check for TTS data
Intent checkTTSIntent = new Intent();
checkTTSIntent.setAction(TextToSpeech.Engine.ACTION_CHECK_TTS_
DATA);
startActivityForResult(checkTTSIntent, MY_DATA_CHECK_CODE);
}
//respond to button clicks
public void Speack_fun(View v) {
//get the text entered
EditText enteredText = (EditText)findViewById(R.id.enter);
String words = enteredText.getText().toString();
speakWords(words);
173
}
//speak the user text
private void speakWords(String words) {
//speak straight away
myTTS.speak(words, TextToSpeech.QUEUE_FLUSH, null);
}
//act on result of TTS data check
@Override
if (requestCode == MY_DATA_CHECK_CODE) {
if (resultCode == TextToSpeech.Engine.CHECK_VOICE_DATA_PASS) {
//the user has the necessary data - create the TTS
myTTS = new TextToSpeech(this, this);
} else {
//no data - install it now
Intent installTTSIntent = new Intent();
installTTSIntent.setAction(TextToSpeech.Engine.ACTION_INSTALL_TTS_DAT
A);
startActivity(installTTSIntent);
}}}
//setup TTS
public void onInit(int initStatus) {
//check for successful instantiation
if (initStatus == TextToSpeech.SUCCESS) {
if(myTTS.isLanguageAvailable(Locale.US)==TextToSpeech.LANG_AVAI
LABLE)
myTTS.setLanguage(Locale.US);
} else if (initStatus == TextToSpeech.ERROR) {
Toast.makeText(this, "Sorry! failed...",
Toast.LENGTH_LONG).show();
}
}}
174
‫الفصل الرابع عشر (‪)Material Design‬‬
‫في هذا الفصل سنتكلم عن طريقة جديدة في التصميم اضافتها جوجل في الـ ‪ ،API 21‬هذه الطريقة تمكننا من‬
‫عمل تأثيرات ‪ 3D‬واشرطة تمرير الى اخره من المميزات‪ ،‬وتم إضافة هذه التأثيرات في عدة مكتبات‪.‬‬
‫انشاء ‪Recyclerview‬‬
‫ما نقصده بالـ ‪ recyclerview‬هو شريط تمرير افقي او عمودي للعناصر‪ ،‬بهذا الشكل‪:‬‬
‫‪175‬‬
‫هذه المربعات الملونة يمكن ان تكون صور او ازرار او أي عنصر ويمكن تمريرها بشكل افقي‪ ،‬سنتعلم االن‬
‫كيف نعمل مثل هذا البرنامج‪ ،‬أوال سننشأ مشروع جديد ونعمل اثنين ‪ actitity‬مع اثنين ‪ layout‬االكتفتي‬
‫األولى الرئيسية سنفترض اسمها ‪ MainActivity‬مرتبطة بالطبقة ‪ ،activity_main‬اما الـ ‪activity‬‬
‫األخرى والتي ستحمل كالس محتويات هذه القائمة اسمها ‪ Main2Activity‬والطبقة المرتبطة بها اسمها‬
‫‪.activity_main2‬‬
‫اول شيء علينا القيام به هو إضافة المكتبات التالية الى الـ ‪Gradle‬‬
‫'‪implementation 'com.android.support:appcompat-v7:27.1.1‬‬
‫'‪implementation 'com.android.support:recyclerview-v7:27.1.1‬‬
‫الضافتها في برنامج االندرويد ستوديو نذهب الى‪:‬‬
‫‪File → Project Structure → App → Dependencies‬‬
‫لتكون النافذه بهذا الشكل‪:‬‬
‫‪176‬‬
‫إذا لم تكن هاتين المكتبتين مضافات نضيفهن من عالمة الزائد الموجودة في اعلى النافذة على جهة اليمين‬
.)‫(كما موضح في الصورة السابقة‬
:‫نأتي االن الى كتابة الكود في كل واحدة منهم‬
:‫ هو‬activity_main.xml ‫الكود في داخل الطبقة‬

<RelativeLayout
id"
android:layout_height="wrap_content">
<android.support.v7.widget.RecyclerView
android:id="@+id/rvAnimals"
android:scrollbars="horizontal" />
177
</RelativeLayout>
:‫ هو‬activity_main2.xml ‫الكود في داخل الطبقة‬

<LinearLayout
id"
android:padding="10dp">
<View
android:id="@+id/colorView"
android:layout_width="100dp"
android:layout_height="100dp" />
<TextView
android:id="@+id/tvAnimalName"
android:textSize="20sp" />
</LinearLayout>
:‫ هو‬Main2Activity.java ‫الكود في داخل الـ‬

import android.content.Context;
import android.support.annotation.NonNull;
import android.support.v7.widget.RecyclerView;
import android.view.LayoutInflater;
import android.view.ViewGroup;
178
import java.util.List;
public class Main2Activity extends

RecyclerView.Adapter<Main2Activity.ViewHolder> {
private List<Integer> mViewColors;
private List<String> mAnimals;
private LayoutInflater mInflater;
private ItemClickListener mClickListener;
// data is passed into the constructor

Main2Activity(Context context, List<Integer> colors,
List<String> animals) {
this.mInflater = LayoutInflater.from(context);
this.mViewColors = colors;
this.mAnimals = animals;
}
// inflates the row layout from xml when needed

@Override
@NonNull
public ViewHolder onCreateViewHolder(@NonNull ViewGroup
parent, int viewType) {
View view =
mInflater.inflate(R.layout.activity_main2, parent,
false);
return new ViewHolder(view);
}
// binds the data to the view and textview in each row

@Override
public void onBindViewHolder(@NonNull ViewHolder
holder, int position) {
int color = mViewColors.get(position);
String animal = mAnimals.get(position);
holder.myView.setBackgroundColor(color);
holder.myTextView.setText(animal);
}
// total number of rows
179
@Override
public int getItemCount() {
return mAnimals.size();
}
// stores and recycles views as they are scrolled off

screen
public class ViewHolder extends RecyclerView.ViewHolder
implements View.OnClickListener {
View myView;
TextView myTextView;
ViewHolder(View itemView) {
super(itemView);
myView = itemView.findViewById(R.id.colorView);
myTextView =
itemView.findViewById(R.id.tvAnimalName);
itemView.setOnClickListener(this);
}
@Override
if (mClickListener != null)
mClickListener.onItemClick(view, getAdapterPosition());
}
}
// convenience method for getting data at click

position
public String getItem(int id) {
return mAnimals.get(id);
}
// allows clicks events to be caught

public void setClickListener(ItemClickListener
itemClickListener) {
this.mClickListener = itemClickListener;
}
// parent activity will implement this method to
180
respond to click events
public interface ItemClickListener {
void onItemClick(View view, int position);
}
}
:MainActivity.java ‫وأخيرا نأتي الى الكود في الـ‬

import android.graphics.Color;
import android.support.v7.widget.LinearLayoutManager;
import android.support.v7.widget.RecyclerView;
import java.util.ArrayList;
public class MainActivity extends AppCompatActivity

implements Main2Activity.ItemClickListener {
private Main2Activity adapter;
@Override
{
// data to populate the RecyclerView with

ArrayList<Integer> viewColors = new
ArrayList<>();
viewColors.add(Color.BLUE);
viewColors.add(Color.YELLOW);
viewColors.add(Color.MAGENTA);
viewColors.add(Color.RED);
viewColors.add(Color.BLACK);
181
ArrayList<String> animalNames = new
ArrayList<>();
animalNames.add("Horse");
animalNames.add("Cow");
animalNames.add("Camel");
animalNames.add("Sheep");
animalNames.add("Goat");
// set up the RecyclerView

RecyclerView recyclerView =
findViewById(R.id.rvAnimals);
LinearLayoutManager horizontalLayoutManagaer =
new LinearLayoutManager(MainActivity.this,
LinearLayoutManager.HORIZONTAL, false);
recyclerView.setLayoutManager(horizontalLayoutManagaer)
;
adapter = new Main2Activity(this, viewColors,
animalNames);
adapter.setClickListener(this);
recyclerView.setAdapter(adapter);
}
@Override
public void onItemClick(View view, int position) {
Toast.makeText(this, "You clicked " +
adapter.getItem(position) + " on item position " +
position, Toast.LENGTH_SHORT).show();
}
}
‫ إذا ردنا ان نعمل قائمة العرض لتكون بشكل‬،‫االن اكتمل عندنا البرنامج وسيكون مثل الصورة في األعلى‬
)MainActivity.java ‫عمودي كل ما علينا فعله هو استبدال هذين السطرين (الموجودين في الملف‬
LinearLayoutManager horizontalLayoutManagaer = new
LinearLayoutManager(MainActivity.this,
182
LinearLayoutManager.HORIZONTAL,
false);
recyclerView.setLayoutManager(horizontalLayoutManagaer)
;
:‫بهذا السطر‬
recyclerView.setLayoutManager(new
LinearLayoutManager(this));
:‫وسيكون شكل البرنامج هكذا‬
183
‫الفصل االخير (مالحظات عامة)‬
‫* اذا كان عندنا المجلد ‪( layout‬لعرض طبقة لجميع االجهزة ما عدا التابلت) والمجلد ‪layout-large‬‬
‫(لعرض طبقة فقط للتابلت) هناك ملف جافا واحد للتعامل مع هذين الطبقتين واردنا من البرنامج ان يتصرف‬
‫بسلوك معين اذا كان الجهاز تابلت وبخالف ذلك يتصرف بسلوك مختلف‪ ،‬يمكن تحديد نوع الجهاز بستخدام‬
‫الدالة ‪ findViewById‬حيث يجب ان تحتوي احدى هذه الطبقات على عنصر بـ ‪ id‬ويكون هذا العنصر‬
‫غير موجود في الطبقة االخرى‪ ،‬مثال اذا افترضنا ان ‪ id‬لعنصر موجود في طبقة التابلت هو ‪ TAB‬يمكن ان‬
‫يكون شكل الكود في ملف الجافا بهذا الشكل‪:‬‬
‫;)‪View X = findViewById(R.id.TAB‬‬
‫{ ) ‪if ( X != null‬‬
‫االن تعرض الطبقة الموجودة في المجلد ‪// layou‬‬
‫{‪} else‬‬
‫االن تعرض الطبقة الموجودة في المجلد ‪// layout-large‬‬
‫}‬
‫‪184‬‬

Android

Uploaded by

Document Information

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Android

Uploaded by

Copyright:

Available Formats

‫‪Android‬‬

‫تعلم برمجة تطبيقات االندرويد من الصفر الى االحتراف‬

‫‪Ahmed Ibrahim‬‬ ‫‪9/7/17‬‬ ‫‪Basrah - Iraq‬‬

‫الملف الرئيسي ‪manifest‬‬

‫>?"‪<?xml version="1.0" encoding="utf-8‬‬

‫والكود في هذا الملف بشكل افتراضي ينشأ بهذا الشكل‪:‬‬

‫الملف النصي ‪strings.xml‬‬

‫>‪<string name="app_name">My Application</string‬‬

‫>‪<string name="My_TextView">The text here</string‬‬

‫مثال الـ ‪ resId‬للوصول الى كلمة ‪ My Application‬في المثال السابق هو (‪)string.app_name.R‬‬

‫>‪<string name="My_Name">The text \n here</string‬‬

‫مصادر البيانات ‪Resources‬‬

‫شروط تسمية المجلدات‬

‫‪Screen Size Screen density Orientation Aspect ratio API level‬‬

‫‪drawable‬‬ ‫‪-small‬‬ ‫‪-ldpi‬‬ ‫‪-land‬‬ ‫‪-long‬‬ ‫…‪-v‬‬

‫‪menu‬‬ ‫‪-large‬‬ ‫‪-hdpi‬‬ ‫‪-v18‬‬

‫‪mipmap‬‬ ‫‪-xlarge‬‬ ‫‪-xhdpi‬‬ ‫‪-v19‬‬

‫‪values‬‬ ‫‪-xxhdpi‬‬ ‫‪-v20‬‬

‫عمل طبقة افقية‬

‫‪Log level‬‬ ‫‪Method‬‬ ‫‪Notes‬‬

‫الصيغة العامة لكل هذه الدوال هي‪:‬‬

‫)‪public static int d(String tag, String msg‬‬

‫;)"‪Log.d("MainActivity", "The message‬‬

‫;)"‪Log.i("info", "The message‬‬

‫;)(‪final Handler h = new Handler‬‬

‫;)(‪final Handler h = new Handler‬‬

‫ادارة الـ ‪ Widgets‬من داخل ملف ‪Java‬‬

‫)‪public View findViewById(int id‬‬

‫;)‪# X = (#) findViewById(ID‬‬

‫;)‪TextView X = (TextView) findViewById(R.id.Y‬‬

‫{ )‪public void test_meth(View v‬‬

‫حفظ واستعادة البيانات‬

‫;) ‪ObBundle.putInt( “Key”, 5‬‬

‫;) “‪int X = ObBundle.getInt( “Key‬‬

‫)‪void onSaveInstanceState(Bundle outState‬‬

‫;"‪private static final String Y = "Z‬‬

‫{ )‪public void onRestoreInstanceState(Bundle savedInstanceState‬‬

‫الحظ اننا مررنا الباراميتر ‪ savedInstanceState‬للدالة االب لهذه الدالة‪.‬‬

‫الفصل الثالث (أكثر من ‪)Activity‬‬

‫الوصول الى ‪ Activity‬من ‪ Activity‬اخرى‬

‫)‪public void startActivity(Intent intent‬‬

‫)‪public Intent(Context packageContext, Class<?> cls‬‬

‫* إذا كانت عندنا اثنين ‪ activity‬االولى اسمها ‪ MainActivity‬والثانية اسمها ‪ Main2Activity‬وعند‬

‫المرحلة االولى االرسال‪:‬‬

‫)‪public Intent putExtra(String name, value‬‬

‫;)‪Intent i = new Intent(MainActivity.this, Main2Activity.class‬‬

‫المرحلة الثانية االستالم‪:‬‬

‫)‪public # get#Extra(String name, # defaultValue‬‬

‫)‪public boolean getBooleanExtra(String name, boolean defaultValue‬‬

‫* تستخدم هذه الدالة مع الدالة السابقة الستالم القيم المرسلة‪.‬‬

‫;)‪int x = getIntent().getIntExtra("KEY", 0‬‬

‫استعادة نتائج من الـ ‪ Activity‬االبن‬

‫)‪public void startActivityForResult(Intent intent, int requestCode‬‬

‫)‪public final void setResult(int resultCode‬‬

‫;)(‪Intent data = new Intent‬‬

‫)‪protected void onActivityResult(int requestCode, int resultCode, Intent data‬‬

)‫ االب‬activity ‫ (يكتب هذا الكود في الـ‬-1

)‫ االبن‬activity ‫ (يكتب هذا الكود في الـ‬-2

‫الفصل الرابع (‪)List views and Adapters‬‬

‫ستكون القائمة بهذا الشكل‪:‬‬

‫‪ OnItemClickListener‬هو كالس داخلي مجهول مع الكالس ‪ AdapterView‬وهنا انشأنا اوبجكت منه‪،‬‬

‫;)‪ListView listView = (ListView) findViewById(R.id.list_options‬‬

‫{‪class myClass implements AdapterView.OnItemClickListener‬‬

‫;)‪ListView listView = (ListView) findViewById(R.id.list_options‬‬