stream chat android

Android SDK الرسمي للدردشة المباشرة

هذا هو Android SDK الرسمي لـ Stream Chat، وهي خدمة لإنشاء تطبيقات الدردشة والمراسلة. تتضمن هذه المكتبة كلاً من SDK للدردشة ذات المستوى المنخفض ومجموعة من مكونات واجهة المستخدم القابلة لإعادة الاستخدام. يبدأ معظم المستخدمين بمكونات واجهة المستخدم، ويعودون إلى واجهة برمجة التطبيقات ذات المستوى الأدنى عندما يريدون تخصيص الأشياء.

نحن فخورون بأن نقول إننا أول Android Chat SDK يدعم Jetpack Compose! لقد أصدرنا مكونات Compose UI الخاصة بنا بعد يوم واحد من الإصدار الرسمي لـ Jetpack Compose 1.0، ويعمل أعضاء فريقنا بجد على ذلك منذ ذلك الحين.

لقد أصبح الآن ناضجًا ومستقرًا بما يكفي لكي نوصي به رسميًا لجميع التطبيقات الجديدة وجميع تطبيقات الدردشة الحديثة. إذا كنت تبحث عن شيء قابل للتخصيص بدرجة عالية وعالي الأداء، فاطلع على Compose SDK الخاص بنا.

يدعم Android SDK كلاً من Kotlin وJava، لكننا نوصي بشدة باستخدام Kotlin .

ملاحظة : يدعم Compose SDK لغة Kotlin فقط، نظرًا لأن Compose يستخدم المكونات الإضافية لمترجم Kotlin لمعالجة واجهة المستخدم.

؟ روابط سريعة

• التسجيل: قم بإنشاء حساب واحصل على مفتاح API لـ Stream Chat
• البرنامج التعليمي للدردشة: تعرف على أساسيات SDK عن طريق إنشاء تطبيق مراسلة بسيط (Kotlin أو Java)
• نموذج تطبيق مكونات واجهة المستخدم: تطبيق مراسلة كامل مع سلاسل الرسائل وردود الفعل وتحديثات واجهة المستخدم المتفائلة والتخزين دون اتصال بالإنترنت
• نموذج تطبيق Compose UI Components: نموذج تطبيق المراسلة الذي تم إنشاؤه باستخدام Jetpack Compose!
• توثيق العميل
• وثائق مكونات واجهة المستخدم
• إنشاء وثائق مكونات واجهة المستخدم
• مستندات API: مستندات تم إنشاؤها بالكامل من Dokka
• تخطيط Jetpack Compose: مجلس إدارة المشروع العام ونظرة عامة على المعالم الرئيسية في Jetpack Compose

‍ مجاني للصناع ?‍

البث مجاني لمعظم المشاريع الجانبية والهوايات. للتأهل، يجب أن يكون لدى مشروعك/شركتك أقل من 5 أعضاء في الفريق وإيرادات شهرية تقل عن 10 آلاف دولار. للحصول على تفاصيل الأسعار الكاملة، قم بزيارة صفحة تسعير الدردشة الخاصة بنا.

⁉️ نظرة عامة وتوثيق

يتكون SDK هذا من عنصرين منخفضي المستوى يمكنك البناء عليهما:

• العميل : عميل منخفض المستوى لإجراء مكالمات API واستقبال أحداث الدردشة.
  • موقع التوثيق
• الدعم دون اتصال : التخزين المؤقت المحلي وإعادة المحاولة التلقائية، يتم عرضهما عبر Flow وLiveData APIs.
  • الدعم دون اتصال

لدينا أيضًا مجموعتي SDK لواجهة المستخدم . يمكنك استخدام Compose UI Components SDK، أو إذا كنت تستخدم حلول واجهة المستخدم الأقدم، فإن مكونات واجهة المستخدم المستندة إلى XML:

• إنشاء مكونات واجهة المستخدم : مكونات قابلة لإعادة الاستخدام وقابلة لإعادة الاستخدام لعرض المحادثات وقوائم القنوات والمزيد!
  • التطبيق عينة
  • التوثيق
  • إنشاء إرشادات SDK
• مكونات واجهة المستخدم : طرق عرض الدردشة قابلة لإعادة الاستخدام وقابلة للتخصيص لعرض المحادثات وقوائم القنوات والمزيد!
  • التطبيق عينة
  • التوثيق

تعرف على المزيد حول الوحدات بزيارة الوثائق.

درس تعليمي

أفضل مكان للبدء هو البرنامج التعليمي لمراسلة الدردشة. فهو يعلمك أساسيات استخدام Compose Chat SDK ويوضح أيضًا كيفية إجراء التغييرات المطلوبة بشكل متكرر.

ملاحظة : إذا كنت تستخدم مجموعات أدوات واجهة المستخدم القديمة، مثل XML، فيمكنك اتباع البرنامج التعليمي لمراسلة دردشة Android والذي يتميز بمكونات واجهة المستخدم المستندة إلى XML.

التثبيت والبدء

راجع صفحات التبعيات والبدء في الوثائق.

؟ تطبيقات عينة

إنشاء تطبيق نموذجي

يأتي تنفيذ Jetpack Compose الخاص بنا مزودًا بتطبيق نموذجي خاص به، والذي يمكنك اللعب به لترى مدى روعة Compose.

لتشغيل نموذج التطبيق، ابدأ باستنساخ هذا الريبو:

git clone [email protected]:GetStream/stream-chat-android.git

بعد ذلك، افتح Android Studio وافتح مجلد المشروع الذي تم إنشاؤه حديثًا. ستحتاج إلى تشغيل الوحدة النمطية stream-chat-android-compose-sample .

نظرًا لأن Compose عبارة عن حزمة SDK قابلة للتخصيص بدرجة كبيرة، فنحن متحمسون لسماع تعليقاتك حول كيفية مساعدتك في إنشاء واجهة مستخدم Chat معقدة. انضم إلينا في مناقشات هذا الريبو أو قم بالتغريد علينا @getstream_io!

نموذج التطبيق

ومع ذلك، إذا كنت لا تزال تستخدم XML بسبب القيود التقنية، فإن SDK لمكونات واجهة المستخدم الخاصة بنا تتضمن نموذجًا لتطبيق كامل الوظائف يضم سلاسل الرسائل والتفاعلات ومؤشرات الكتابة وتحديثات واجهة المستخدم المتفائلة والتخزين دون اتصال. لتشغيل نموذج التطبيق، ابدأ باستنساخ هذا الريبو:

git clone [email protected]:GetStream/stream-chat-android.git

بعد ذلك، افتح Android Studio وافتح مجلد المشروع الذي تم إنشاؤه حديثًا. ستحتاج إلى تشغيل تطبيق stream-chat-android-ui-components-sample .

تطبيقات عينة أخرى

نحتفظ أيضًا بمستودع مخصص لتطبيقات العينات الكاملة على GetStream/Android-Samples.

الميزات المدعومة؟

فيما يلي بعض الميزات التي يدعمها SDK خارج الصندوق:

• واجهة قائمة القنوات
• واجهة مستخدم القناة
• ردود أفعال الرسالة
• معاينات الارتباط
• مرفقات الصور والفيديو والملفات
• تحرير وحذف الرسائل
• مؤشرات الكتابة
• قراءة المؤشرات
• دفع الإخطارات
• معرض الصور
• دعم GIF
• المواضيع الخفيفة والمظلمة
• تخصيص النمط
• تخصيص واجهة المستخدم
• المواضيع
• أوامر القطع
• تنسيق الرسالة Markdown
• عدد الرسائل غير المقروءة

للمزيد، راجع موقع SDK.

R8 / بروجارد

عند استخدام R8 ، يتم تطبيق قواعد التقليص والتشويش تلقائيًا.

إذا كنت تستخدم ProGuard ، فستحتاج إلى إضافة القواعد التالية من وحدات العميل وواجهة المستخدم المشتركة ومعاينة البيانات إلى تطبيقك.

قد تحتاج أيضًا إلى تطبيق قواعد لـ Coroutines وRetrofit وOkHttp التي تعتبر تبعيات لـ SDK.

نحن نوظف!

لقد أنهينا مؤخرًا جولة تمويل من السلسلة B بقيمة 38 مليون دولار ونواصل النمو بنشاط. يتم استخدام واجهات برمجة التطبيقات الخاصة بنا من قبل أكثر من مليار مستخدم نهائي، وستكون لديك فرصة لإحداث تأثير كبير على المنتج ضمن فريق من أقوى المهندسين في جميع أنحاء العالم. تحقق من الفتحات الحالية لدينا وتقدم بطلب عبر موقع Stream الإلكتروني.

رخصة

 Copyright (c) 2014-2022 Stream.io Inc. All rights reserved.

Licensed under the Stream License;
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   https://github.com/GetStream/stream-chat-android/blob/main/LICENSE

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.