1. खास जानकारी
इमेज: Working Friendly Chat ऐप्लिकेशन.
फ़्रेंडली चैट कोडलैब (कोड बनाना सीखना) में आपका स्वागत है. इस कोडलैब में, आपको Android पर चैट ऐप्लिकेशन बनाने के लिए, Firebase प्लैटफ़ॉर्म का इस्तेमाल करने का तरीका पता चलेगा.
आपको यह जानकारी मिलेगी
- उपयोगकर्ताओं को साइन इन करने की अनुमति देने के लिए, Firebase Authentication का इस्तेमाल करने का तरीका.
- Firebase रीयल टाइम डेटाबेस का इस्तेमाल करके डेटा सिंक करने का तरीका.
- Firebase के लिए Cloud Storage में बाइनरी फ़ाइलें सेव करने का तरीका.
- Firebase के साथ कोई Android ऐप्लिकेशन बनाने के लिए, Firebase लोकल एम्युलेटर सुइट का इस्तेमाल कैसे करें.
आपको इन चीज़ों की ज़रूरत होगी
- Android Studio का सबसे नया वर्शन.
- Android 5.0 के बाद के वर्शन वाला Android Emulator.
- Emulator Suite का इस्तेमाल करने के लिए, Node.js का 10 या उसके बाद का वर्शन.
- Java 8 या इसके बाद का वर्शन. Java इंस्टॉल करने के लिए, इन निर्देशों का इस्तेमाल करें; अपना वर्शन देखने के लिए,
java -version
चलाएं. - Kotlin की प्रोग्रामिंग भाषा की जानकारी.
2. सैंपल कोड पाना
डेटा स्टोर करने की जगह का क्लोन बनाएं
कमांड लाइन से GitHub के डेटा स्टोर करने की जगह को क्लोन करें:
$ git clone https://github.com/firebase/codelab-friendlychat-android
Android Studio में इंपोर्ट करना
Android Studio में, फ़ाइल > खोलें चुनें. इसके बाद, उस डायरेक्ट्री से build-android-start
डायरेक्ट्री ( ) चुनें जहां आपने सैंपल कोड डाउनलोड किया था.
अब आपके पास Android Studio में build-android-start
प्रोजेक्ट खुला होना चाहिए. अगर आपको google-services.json
फ़ाइल मौजूद न होने की चेतावनी दिखती है, तो चिंता न करें. इसे बाद के चरण में जोड़ा जाएगा.
डिपेंडेंसी की जांच करना
इस कोडलैब में, ऐसी सभी डिपेंडेंसी जो आपको पहले से जोड़नी होंगी, लेकिन आपके ऐप्लिकेशन में Firebase SDK टूल जोड़ने का तरीका समझना ज़रूरी है:
build.gradle.kts
plugins {
id("com.android.application") version "8.0.0" apply false
id("com.android.library") version "8.0.0" apply false
id("org.jetbrains.kotlin.android") version "1.8.20" apply false
// The google-services plugin is required to parse the google-services.json file
id("com.google.gms.google-services") version "4.3.15" apply false
}
app/build.gradle.kts
plugins {
id("com.android.application")
id("kotlin-android")
id("com.google.gms.google-services")
}
android {
// ...
}
dependencies {
// ...
// Google Sign In SDK
implementation("com.google.android.gms:play-services-auth:20.5.0")
// Firebase SDK
implementation(platform("com.google.firebase:firebase-bom:32.0.0"))
implementation("com.google.firebase:firebase-database-ktx")
implementation("com.google.firebase:firebase-storage-ktx")
implementation("com.google.firebase:firebase-auth-ktx")
// Firebase UI Library
implementation("com.firebaseui:firebase-ui-auth:8.0.2")
implementation("com.firebaseui:firebase-ui-database:8.0.2")
}
3. Firebase सीएलआई इंस्टॉल करें
इस कोडलैब में, आप स्थानीय तौर पर Firebase पुष्टि, रीयलटाइम डेटाबेस, और Cloud Storage को एम्युलेट करने के लिए Firebase एम्युलेटर सुइट का इस्तेमाल करेंगे. इससे, ऐप्लिकेशन बनाने के लिए, स्थानीय डेवलपमेंट का ऐसा सुरक्षित, तेज़, और बिना किसी शुल्क वाला प्लैटफ़ॉर्म मिलता है.
Firebase CLI इंस्टॉल करना
सबसे पहले, आपको Firebase CLI इंस्टॉल करना होगा. macOS या Linux का इस्तेमाल करने वाले लोग, cURL का यह कमांड चला सकते हैं:
curl -sL https://firebase.tools | bash
अगर Windows का इस्तेमाल किया जा रहा है, तो स्टैंडअलोन बाइनरी पाने या npm
के ज़रिए इंस्टॉल करने के लिए इंस्टॉल करने के निर्देश पढ़ें.
सीएलआई इंस्टॉल करने के बाद, firebase --version
को 9.0.0
या इसके बाद वाले वर्शन के वर्शन की रिपोर्ट करनी चाहिए:
$ firebase --version 9.0.0
प्रवेश करें
सीएलआई को अपने Google खाते से कनेक्ट करने के लिए, firebase login
चलाएं. इससे लॉगिन की प्रोसेस पूरी करने के लिए एक नई ब्राउज़र विंडो खुलेगी. पक्का करें कि आपने उसी खाते को चुना है जिसका इस्तेमाल, आपने Firebase प्रोजेक्ट बनाते समय किया था.
4. Firebase Emulator Suite से कनेक्ट करना
एम्युलेटर शुरू करें
अपने टर्मिनल में, अपनी लोकल codelab-friendlychat-android
डायरेक्ट्री के रूट से यहां दिया गया कमांड चलाएं:
firebase emulators:start --project=demo-friendlychat-android
आपको कुछ इस तरह के लॉग दिखेंगे. पोर्ट की वैल्यू, firebase.json
फ़ाइल में बताई गई थीं, जो क्लोन किए गए सैंपल कोड में शामिल थीं.
$ firebase emulators:start --project=demo-friendlychat-android
i emulators: Starting emulators: auth, database, storage
i emulators: Detected demo project ID "demo-friendlychat-android", emulated services will use a demo configuration and attempts to access non-emulated services for this project will fail.
i database: Database Emulator logging to database-debug.log
i ui: Emulator UI logging to ui-debug.log
┌─────────────────────────────────────────────────────────────┐
│ ✔ All emulators ready! It is now safe to connect your app. │
│ i View Emulator UI at http://localhost:4000 │
└─────────────────────────────────────────────────────────────┘
┌────────────────┬────────────────┬────────────────────────────────┐
│ Emulator │ Host:Port │ View in Emulator UI │
├────────────────┼────────────────┼────────────────────────────────┤
│ Authentication │ localhost:9099 │ http://localhost:4000/auth │
├────────────────┼────────────────┼────────────────────────────────┤
│ Database │ localhost:9000 │ http://localhost:4000/database │
├────────────────┼────────────────┼────────────────────────────────┤
│ Storage │ localhost:9199 │ http://localhost:4000/storage │
└────────────────┴────────────────┴────────────────────────────────┘
Emulator Hub running at localhost:4400
Other reserved ports: 4500
Issues? Report them at https://github.com/firebase/firebase-tools/issues and attach the *-debug.log files.
Firebase Emulator Suite का यूज़र इंटरफ़ेस (यूआई) देखने के लिए, अपने वेब ब्राउज़र में http://localhost:4000 पर जाएं:
कोडलैब के बाकी हिस्से के लिए, emulators:start
कमांड को चलने दें.
अपना ऐप्लिकेशन कनेक्ट करें
Android Studio में, MainActivity.kt
खोलें. इसके बाद, onCreate
तरीके में यह कोड जोड़ें:
// When running in debug mode, connect to the Firebase Emulator Suite.
// "10.0.2.2" is a special IP address which allows the Android Emulator
// to connect to "localhost" on the host computer. The port values (9xxx)
// must match the values defined in the firebase.json file.
if (BuildConfig.DEBUG) {
Firebase.database.useEmulator("10.0.2.2", 9000)
Firebase.auth.useEmulator("10.0.2.2", 9099)
Firebase.storage.useEmulator("10.0.2.2", 9199)
}
5. स्टार्टर ऐप्लिकेशन चलाना
google-services.json जोड़ना
अपने Android ऐप्लिकेशन को Firebase से कनेक्ट करने के लिए, आपको अपने Android प्रोजेक्ट के app
फ़ोल्डर में एक google-services.json
फ़ाइल जोड़नी होगी. इस कोडलैब के लिए, हमने एक मॉक JSON फ़ाइल दी है. इसकी मदद से, Firebase Emulator Suite से कनेक्ट किया जा सकता है.
mock-google-services.json
फ़ाइल को build-android-start/app
फ़ोल्डर में, google-services.json
के तौर पर कॉपी करें:
cp mock-google-services.json build-android-start/app/google-services.json
इस कोडलैब के आखिरी चरण में, आपको Firebase प्रोजेक्ट और Firebase का Android ऐप्लिकेशन बनाने का तरीका बताया जाएगा. इससे, नकली JSON फ़ाइल को अपने कॉन्फ़िगरेशन से बदला जा सकेगा.
ऐप्लिकेशन चलाएं
आपने Android Studio में प्रोजेक्ट इंपोर्ट कर लिया है और Firebase कॉन्फ़िगरेशन JSON फ़ाइल जोड़ ली है. इसलिए, अब ऐप्लिकेशन को पहली बार चलाया जा सकता है.
- अपना Android Emulator चालू करें.
- Android Studio में, टूलबार में रन करें ( ) पर क्लिक करें.
ऐप्लिकेशन आपके Android एम्युलेटर पर लॉन्च होना चाहिए. इसके बाद, आपको मैसेज की खाली सूची दिखेगी. साथ ही, मैसेज भेजने और पाने की सुविधा काम नहीं करेगी. इस कोडलैब के अगले चरण में, आपको उपयोगकर्ताओं की पुष्टि करनी होगी, ताकि वे फ़्रेंडली चैट का इस्तेमाल कर सकें.
6. पुष्टि करने की प्रक्रिया चालू करें
यह ऐप्लिकेशन, सभी चैट मैसेज को सेव करने के लिए Firebase रीयलटाइम डेटाबेस का इस्तेमाल करेगा. हालांकि, डेटा जोड़ने से पहले, हमें यह पक्का करना होगा कि ऐप्लिकेशन सुरक्षित है और सिर्फ़ पुष्टि किए गए उपयोगकर्ता ही मैसेज पोस्ट कर सकते हैं. इस चरण में, हम Firebase Authentication को चालू करेंगे और रीयलटाइम डेटाबेस के सुरक्षा नियमों को कॉन्फ़िगर करेंगे.
साइन-इन करने की बुनियादी सुविधाएं जोड़ें
इसके बाद हम उपयोगकर्ताओं का पता लगाने और साइन-इन स्क्रीन लागू करने के लिए ऐप्लिकेशन में कुछ बुनियादी Firebase पुष्टि कोड जोड़ेंगे.
मौजूदा उपयोगकर्ता की जांच करना
सबसे पहले, MainActivity.kt
क्लास में इन इंस्टेंस वैरिएबल को जोड़ें:
MainActivity.kt
// Firebase instance variables
private lateinit var auth: FirebaseAuth
अब MainActivity
में बदलाव करते हैं, ताकि जब भी उपयोगकर्ता की पुष्टि न हुई हो और ऐप्लिकेशन को खोला जाए, तो उसे साइन इन स्क्रीन पर भेजा जाए. व्यू से binding
के अटैच होने के बाद, onCreate()
तरीके में यह तरीका जोड़ें:
MainActivity.kt
// Initialize Firebase Auth and check if the user is signed in
auth = Firebase.auth
if (auth.currentUser == null) {
// Not signed in, launch the Sign In activity
startActivity(Intent(this, SignInActivity::class.java))
finish()
return
}
हम यह भी देखना चाहते हैं कि onStart()
के दौरान, उपयोगकर्ता ने साइन इन किया है या नहीं:
MainActivity.kt
public override fun onStart() {
super.onStart()
// Check if user is signed in.
if (auth.currentUser == null) {
// Not signed in, launch the Sign In activity
startActivity(Intent(this, SignInActivity::class.java))
finish()
return
}
}
इसके बाद, getUserPhotoUrl()
और getUserName()
तरीके लागू करें, ताकि पुष्टि किए गए मौजूदा Firebase उपयोगकर्ता के बारे में सही जानकारी मिल सके:
MainActivity.kt
private fun getPhotoUrl(): String? {
val user = auth.currentUser
return user?.photoUrl?.toString()
}
private fun getUserName(): String? {
val user = auth.currentUser
return if (user != null) {
user.displayName
} else ANONYMOUS
}
इसके बाद, 'साइन आउट करें' बटन को मैनेज करने के लिए, signOut()
तरीका लागू करें:
MainActivity.kt
private fun signOut() {
AuthUI.getInstance().signOut()
startActivity(Intent(this, SignInActivity::class.java))
finish()
}
अब हमारे पास ज़रूरत पड़ने पर, उपयोगकर्ता को साइन-इन स्क्रीन पर भेजने के लिए पूरा लॉजिक है. इसके बाद, हमें उपयोगकर्ताओं की सही तरीके से पुष्टि करने के लिए, साइन-इन स्क्रीन चालू करनी होगी.
साइन इन स्क्रीन लागू करना
फ़ाइल SignInActivity.kt
खोलें. यहां पुष्टि करने के लिए, साइन इन करने के लिए बटन का इस्तेमाल किया गया है. इस सेक्शन में, साइन इन के लिए लॉजिक लागू करने के लिए आपको FirebaseUI का इस्तेमाल करना होगा.
// Firebase instance variables
टिप्पणी के नीचे, SignInActivity
क्लास में Auth इंस्टेंस वैरिएबल जोड़ें:
SignInActivity.kt
// Firebase instance variables
private lateinit var auth: FirebaseAuth
इसके बाद, Firebase को शुरू करने के लिए onCreate()
तरीके में उसी तरह बदलाव करें जिस तरह आपने MainActivity
में किया था:
SignInActivity.kt
// Initialize FirebaseAuth
auth = Firebase.auth
SignInActivity
में ActivityResultLauncher
फ़ील्ड जोड़ें:
SignInActivity.kt
// ADD THIS
private val signIn: ActivityResultLauncher<Intent> =
registerForActivityResult(FirebaseAuthUIActivityResultContract(), this::onSignInResult)
override fun onCreate(savedInstanceState: Bundle?) {
// ...
}
इसके बाद, FirebaseUI साइन इन फ़्लो को शुरू करने के लिए, onStart()
तरीके में बदलाव करें:
SignInActivity.kt
public override fun onStart() {
super.onStart()
// If there is no signed in user, launch FirebaseUI
// Otherwise head to MainActivity
if (Firebase.auth.currentUser == null) {
// Sign in with FirebaseUI, see docs for more details:
// https://firebase.google.com/docs/auth/android/firebaseui
val signInIntent = AuthUI.getInstance()
.createSignInIntentBuilder()
.setLogo(R.mipmap.ic_launcher)
.setAvailableProviders(listOf(
AuthUI.IdpConfig.EmailBuilder().build(),
AuthUI.IdpConfig.GoogleBuilder().build(),
))
.build()
signIn.launch(signInIntent)
} else {
goToMainActivity()
}
}
इसके बाद, साइन इन वाले नतीजे को मैनेज करने के लिए, onSignInResult
तरीका लागू करें. अगर साइन इन करने की प्रोसेस पूरी हो गई है, तो MainActivity
पर जाएं:
SignInActivity.kt
private fun onSignInResult(result: FirebaseAuthUIAuthenticationResult) {
if (result.resultCode == RESULT_OK) {
Log.d(TAG, "Sign in successful!")
goToMainActivity()
} else {
Toast.makeText(
this,
"There was an error signing in",
Toast.LENGTH_LONG).show()
val response = result.idpResponse
if (response == null) {
Log.w(TAG, "Sign in canceled")
} else {
Log.w(TAG, "Sign in error", response.error)
}
}
}
बस हो गया! आपने FirebaseUI की मदद से, पुष्टि करने की सुविधा को सिर्फ़ कुछ तरीकों के कॉल में लागू किया है. इसके लिए, आपको सर्वर साइड कॉन्फ़िगरेशन को मैनेज करने की ज़रूरत नहीं पड़ी.
अपने काम की जांच करें
अपने Android एम्युलेटर पर ऐप्लिकेशन चलाएं. इसके बाद, आपको तुरंत साइन-इन स्क्रीन पर भेज दिया जाएगा. ईमेल से साइन इन करें बटन पर टैप करें. इसके बाद, खाता बनाएं. अगर सब कुछ सही तरीके से लागू किया गया है, तो आपको मैसेजिंग स्क्रीन पर भेज दिया जाएगा.
साइन इन करने के बाद, अपने ब्राउज़र में Firebase Emulator Suite का यूज़र इंटरफ़ेस (यूआई) खोलें. इसके बाद, पहली बार साइन इन किए गए इस उपयोगकर्ता खाते को देखने के लिए पुष्टि करें टैब पर क्लिक करें.
7. मैसेज पढ़ना
इस चरण में, हम रीयल टाइम डेटाबेस में सेव किए गए मैसेज पढ़ने और दिखाने की सुविधा जोड़ेंगे.
मैसेज के नमूने इंपोर्ट करें
- Firebase Emulator Suite के यूज़र इंटरफ़ेस (यूआई) में, रीयलटाइम डेटाबेस टैब चुनें.
- कोडलैब के रिपॉज़िटरी की अपनी लोकल कॉपी से
initial_messages.json
फ़ाइल को खींचें और डेटा व्यूअर में छोड़ें.
अब आपके पास डेटाबेस के messages
नोड में कुछ मैसेज होने चाहिए.
डेटा पढ़ना
मैसेज सिंक करना
इस सेक्शन में, हम ऐसा कोड जोड़ते हैं जो नए जोड़े गए मैसेज को ऐप्लिकेशन के यूज़र इंटरफ़ेस (यूआई) के साथ सिंक करता है. इसके लिए, यह कोड:
- Firebase रीयल टाइम डेटाबेस को शुरू करना और डेटा में किए गए बदलावों को मैनेज करने के लिए लिसनर जोड़ना.
RecyclerView
अडैप्टर को अपडेट करना, ताकि नए मैसेज दिखें.MainActivity
क्लास में, अपने अन्य Firebase इंस्टेंस वैरिएबल के साथ डेटाबेस इंस्टेंस वैरिएबल जोड़ना:
MainActivity.kt
// Firebase instance variables
// ...
private lateinit var db: FirebaseDatabase
private lateinit var adapter: FriendlyMessageAdapter
नीचे बताए गए कोड के साथ, // Initialize Realtime Database and FirebaseRecyclerAdapter
टिप्पणी में अपने MainActivity onCreate()
मेथड में बदलाव करें. यह कोड रीयल टाइम डेटाबेस से सभी मौजूदा मैसेज जोड़ता है. इसके बाद, आपके Firebase रीयल टाइम डेटाबेस के messages
पाथ में नई चाइल्ड एंट्री को सुनता है. इससे हर मैसेज के लिए यूज़र इंटरफ़ेस (यूआई) में एक नया एलिमेंट जुड़ जाता है:
MainActivity.kt
// Initialize Realtime Database
db = Firebase.database
val messagesRef = db.reference.child(MESSAGES_CHILD)
// The FirebaseRecyclerAdapter class and options come from the FirebaseUI library
// See: https://github.com/firebase/FirebaseUI-Android
val options = FirebaseRecyclerOptions.Builder<FriendlyMessage>()
.setQuery(messagesRef, FriendlyMessage::class.java)
.build()
adapter = FriendlyMessageAdapter(options, getUserName())
binding.progressBar.visibility = ProgressBar.INVISIBLE
manager = LinearLayoutManager(this)
manager.stackFromEnd = true
binding.messageRecyclerView.layoutManager = manager
binding.messageRecyclerView.adapter = adapter
// Scroll down when a new message arrives
// See MyScrollToBottomObserver for details
adapter.registerAdapterDataObserver(
MyScrollToBottomObserver(binding.messageRecyclerView, adapter, manager)
)
इसके बाद, FriendlyMessageAdapter.kt
क्लास में, इनर क्लास MessageViewHolder()
में bind()
तरीका लागू करें:
AdaptiveMessageAdapter.kt
inner class MessageViewHolder(private val binding: MessageBinding) : ViewHolder(binding.root) {
fun bind(item: FriendlyMessage) {
binding.messageTextView.text = item.text
setTextColor(item.name, binding.messageTextView)
binding.messengerTextView.text = if (item.name == null) ANONYMOUS else item.name
if (item.photoUrl != null) {
loadImageIntoView(binding.messengerImageView, item.photoUrl!!)
} else {
binding.messengerImageView.setImageResource(R.drawable.ic_account_circle_black_36dp)
}
}
...
}
हमें इमेज वाले मैसेज भी दिखाने हैं. इसलिए, इनर क्लास ImageMessageViewHolder()
में bind()
तरीका भी लागू करें:
AdaptiveMessageAdapter.kt
inner class ImageMessageViewHolder(private val binding: ImageMessageBinding) :
ViewHolder(binding.root) {
fun bind(item: FriendlyMessage) {
loadImageIntoView(binding.messageImageView, item.imageUrl!!)
binding.messengerTextView.text = if (item.name == null) ANONYMOUS else item.name
if (item.photoUrl != null) {
loadImageIntoView(binding.messengerImageView, item.photoUrl!!)
} else {
binding.messengerImageView.setImageResource(R.drawable.ic_account_circle_black_36dp)
}
}
}
आखिर में, MainActivity
में वापस जाकर, Firebase रीयलटाइम डेटाबेस से अपडेट सुनना शुरू और बंद करें. MainActivity
में onPause()
और onResume()
तरीकों को अपडेट करें, जैसा कि यहां दिखाया गया है:
MainActivity.kt
public override fun onPause() {
adapter.stopListening()
super.onPause()
}
public override fun onResume() {
super.onResume()
adapter.startListening()
}
मैसेज सिंक होने की सुविधा की जांच करना
- चालू करें ( ) पर क्लिक करें.
- एम्युलेटर सुइट के यूज़र इंटरफ़ेस (यूआई) में, रीयलटाइम डेटाबेस टैब पर वापस जाएं. इसके बाद, मैन्युअल तरीके से नया मैसेज जोड़ें. पुष्टि करें कि मैसेज आपके Android ऐप्लिकेशन में दिख रहा है:
बधाई हो, आपने अपने ऐप्लिकेशन में रीयल टाइम डेटाबेस जोड़ दिया है!
8. मैसेज भेजना
मैसेज भेजने की सुविधा लागू करना
इस सेक्शन में, आपको ऐप्लिकेशन के उपयोगकर्ताओं के लिए मैसेज भेजने की सुविधा मिलेगी. नीचे दिया गया कोड स्निपेट, भेजें बटन पर क्लिक इवेंट को सुनता है. साथ ही, मैसेज फ़ील्ड के कॉन्टेंट के साथ एक नया FriendlyMessage
ऑब्जेक्ट बनाता है और मैसेज को डेटाबेस में पुश करता है. push()
तरीका, पुश किए गए ऑब्जेक्ट के पाथ में अपने-आप जनरेट होने वाला आईडी जोड़ता है. ये आईडी क्रम में होते हैं. इससे यह पक्का होता है कि नए मैसेज, सूची में सबसे आखिर में जोड़े जाएंगे.
MainActivity
क्लास में onCreate()
तरीके में, भेजें बटन के क्लिक लिसनर को अपडेट करें. यह कोड, पहले से मौजूद onCreate()
तरीके में सबसे नीचे मौजूद है. नीचे दिए गए कोड से मैच करने के लिए, onClick()
के मुख्य हिस्से को अपडेट करें:
MainActivity.kt
// Disable the send button when there's no text in the input field
// See MyButtonObserver for details
binding.messageEditText.addTextChangedListener(MyButtonObserver(binding.sendButton))
// When the send button is clicked, send a text message
binding.sendButton.setOnClickListener {
val friendlyMessage = FriendlyMessage(
binding.messageEditText.text.toString(),
getUserName(),
getPhotoUrl(),
null /* no image */
)
db.reference.child(MESSAGES_CHILD).push().setValue(friendlyMessage)
binding.messageEditText.setText("")
}
इमेज मैसेज भेजने की सुविधा लागू करें
इस सेक्शन में, आपको ऐप्लिकेशन के उपयोगकर्ताओं के लिए इमेज मैसेज भेजने की सुविधा मिलेगी. इमेज वाला मैसेज बनाने के लिए, यह तरीका अपनाएं:
- इमेज चुनें
- इमेज चुनने का काम मैनेज करें
- रीयल टाइम डेटाबेस में कुछ समय के लिए दिखने वाली इमेज का मैसेज लिखना
- चुनी गई इमेज अपलोड करना शुरू करें
- अपलोड पूरा होने के बाद, इमेज मैसेज का यूआरएल, अपलोड की गई इमेज के यूआरएल से बदलें
इमेज चुनें
इमेज जोड़ने के लिए यह कोडलैब, Firebase के लिए Cloud Storage का इस्तेमाल करता है. अपने ऐप्लिकेशन का बाइनरी डेटा सेव करने के लिए, Cloud Storage एक अच्छी जगह है.
इमेज चुनने का काम मैनेज करें और तापमान के बारे में मैसेज लिखें
उपयोगकर्ता के किसी इमेज को चुनने के बाद, इमेज चुनने की सुविधा Intent
लॉन्च हो जाती है. यह onCreate()
तरीके के आखिर में, कोड में पहले से ही लागू है. इसके पूरा होने पर, यह MainActivity
के onImageSelected()
मेथड को कॉल करता है. नीचे दिए गए कोड स्निपेट का इस्तेमाल करके, डेटाबेस में इमेज के अस्थायी यूआरएल के साथ एक मैसेज लिखा जाएगा. इससे यह पता चलेगा कि इमेज अपलोड की जा रही है.
MainActivity.kt
private fun onImageSelected(uri: Uri) {
Log.d(TAG, "Uri: $uri")
val user = auth.currentUser
val tempMessage = FriendlyMessage(null, getUserName(), getPhotoUrl(), LOADING_IMAGE_URL)
db.reference
.child(MESSAGES_CHILD)
.push()
.setValue(
tempMessage,
DatabaseReference.CompletionListener { databaseError, databaseReference ->
if (databaseError != null) {
Log.w(
TAG, "Unable to write message to database.",
databaseError.toException()
)
return@CompletionListener
}
// Build a StorageReference and then upload the file
val key = databaseReference.key
val storageReference = Firebase.storage
.getReference(user!!.uid)
.child(key!!)
.child(uri.lastPathSegment!!)
putImageInStorage(storageReference, uri, key)
})
}
इमेज अपलोड करना और मैसेज अपडेट करना
putImageInStorage()
को MainActivity
में जोड़ें. चुनी गई इमेज को अपलोड करने के लिए, इसे onImageSelected()
में कॉल किया जाता है. अपलोड पूरा होने के बाद, आपको सही इमेज का इस्तेमाल करने के लिए मैसेज अपडेट करना होगा.
MainActivity.kt
private fun putImageInStorage(storageReference: StorageReference, uri: Uri, key: String?) {
// First upload the image to Cloud Storage
storageReference.putFile(uri)
.addOnSuccessListener(
this
) { taskSnapshot -> // After the image loads, get a public downloadUrl for the image
// and add it to the message.
taskSnapshot.metadata!!.reference!!.downloadUrl
.addOnSuccessListener { uri ->
val friendlyMessage =
FriendlyMessage(null, getUserName(), getPhotoUrl(), uri.toString())
db.reference
.child(MESSAGES_CHILD)
.child(key!!)
.setValue(friendlyMessage)
}
}
.addOnFailureListener(this) { e ->
Log.w(
TAG,
"Image upload task was unsuccessful.",
e
)
}
}
मैसेज भेजने की जांच करना
- Android Studio में, चलाएं बटन पर क्लिक करें.
- अपने Android एमुलेटर में कोई मैसेज डालें. इसके बाद, भेजें बटन पर टैप करें. नया मैसेज, ऐप्लिकेशन के यूज़र इंटरफ़ेस (यूआई) और Firebase Emulator Suite के यूज़र इंटरफ़ेस (यूआई) में दिखना चाहिए.
- Android Emulator में, अपने डिवाइस से कोई इमेज चुनने के लिए "+" इमेज पर टैप करें. नया मैसेज, सबसे पहले प्लेसहोल्डर इमेज के साथ दिखेगा. इसके बाद, इमेज अपलोड होने के बाद, चुनी गई इमेज के साथ दिखेगा. नया मैसेज, Emulator Suite के यूज़र इंटरफ़ेस (यूआई) में भी दिखना चाहिए. खास तौर पर, रीयलटाइम डेटाबेस टैब में किसी ऑब्जेक्ट के तौर पर और स्टोरेज टैब में ब्लॉब के तौर पर.
9. बधाई हो!
आपने Firebase का इस्तेमाल करके, रीयल-टाइम चैट ऐप्लिकेशन बना लिया है!
आपने क्या सीखा
- Firebase से पुष्टि करना
- Firebase रीयल टाइम डेटाबेस
- Firebase के लिए Cloud Storage
इसके बाद, Firebase को अपने Android ऐप्लिकेशन में जोड़ने के लिए, इस कोडलैब में सीखी गई बातों का इस्तेमाल करके देखें! Firebase के बारे में ज़्यादा जानने के लिए, firebase.google.com पर जाएं.
अगर आपको असली Firebase प्रोजेक्ट सेट अप करने और असली Firebase संसाधनों (न कि डेमो प्रोजेक्ट और सिर्फ़ एम्युलेट किए गए संसाधनों) का इस्तेमाल करने का तरीका जानना है, तो अगले चरण पर जाएं.
ध्यान दें: जब आप असली Firebase प्रोजेक्ट सेट अप कर लें और खास तौर पर, जब आप असली ऐप्लिकेशन बनाना शुरू कर दें, तब भी हम डेवलपमेंट और जांच के लिए Firebase लोकल एम्युलेटर सुइट का इस्तेमाल करने का सुझाव देते हैं.
10. ज़रूरी नहीं: Firebase प्रोजेक्ट बनाना और सेट अप करना
इस चरण में, आपको इस कोडलैब के साथ इस्तेमाल करने के लिए, एक असल Firebase प्रोजेक्ट और Firebase Android ऐप्लिकेशन बनाना होगा. आपको अपने ऐप्लिकेशन में, ऐप्लिकेशन के हिसाब से Firebase कॉन्फ़िगरेशन भी जोड़ना होगा. आखिर में, आपको अपने ऐप्लिकेशन के साथ इस्तेमाल करने के लिए, Firebase के असली संसाधन सेट अप करने होंगे.
Firebase प्रोजेक्ट बनाना
- ब्राउज़र में, Firebase कंसोल पर जाएं.
- प्रोजेक्ट जोड़ें को चुनें.
- प्रोजेक्ट का नाम चुनें या डालें. आपके पास अपनी पसंद का कोई भी नाम इस्तेमाल करने का विकल्प है.
- आपको इस कोडलैब के लिए Google Analytics की ज़रूरत नहीं है. इसलिए, अगर आप चाहें, तो अपने प्रोजेक्ट के लिए इसे चालू न करें.
- प्रोजेक्ट बनाएं पर क्लिक करें. प्रोजेक्ट तैयार होने के बाद, जारी रखें पर क्लिक करें.
Firebase प्राइसिंग प्लान को अपग्रेड करना
'Firebase के लिए Cloud Storage' का इस्तेमाल करने के लिए, आपका Firebase प्रोजेक्ट पे-ऐज़-यू-गो (Blaze) कीमत वाले प्लान पर होना चाहिए. इसका मतलब है कि यह Cloud Billing खाते से लिंक होना चाहिए.
- क्लाउड बिलिंग खाते के लिए, पेमेंट का कोई तरीका ज़रूरी है, जैसे कि क्रेडिट कार्ड.
- अगर आपने Firebase और Google Cloud का इस्तेमाल पहले कभी नहीं किया है, तो देखें कि क्या आपको 300 डॉलर का क्रेडिट और मुफ़्त में आज़माने के लिए Cloud Billing खाता मिल सकता है.
- अगर आपने किसी इवेंट के तहत यह कोडलैब किया है, तो इवेंट के आयोजक से पूछें कि क्या कोई Cloud क्रेडिट उपलब्ध है.
अपने प्रोजेक्ट को Blaze प्लान में अपग्रेड करने के लिए, यह तरीका अपनाएं:
- Firebase कंसोल में, अपना प्लान अपग्रेड करें को चुनें.
- ब्लेज़ प्लान चुनें. अपने प्रोजेक्ट से क्लाउड बिलिंग खाता लिंक करने के लिए, स्क्रीन पर दिए गए निर्देशों का पालन करें.
अगर आपको इस अपग्रेड के तहत क्लाउड बिलिंग खाता बनाना पड़ा है, तो अपग्रेड पूरा करने के लिए, आपको Firebase Console में अपग्रेड फ़्लो पर वापस जाना पड़ सकता है.
अपने Android प्रोजेक्ट में Firebase जोड़ना
यह चरण शुरू करने से पहले, अपने ऐप्लिकेशन का SHA1 हैश पाएं. अपनी डीबग कुंजी का SHA1 तय करने के लिए, अपनी स्थानीय build-android-start
डायरेक्ट्री से नीचे दिया गया निर्देश चलाएं:
./gradlew signingReport Store: /Users/<username>/.android/debug.keystore Alias: AndroidDebugKey MD5: A5:88:41:04:8F:06:59:6A:AE:33:76:87:AA:AD:19:23 SHA1: A7:89:F5:06:A8:07:A1:22:EC:90:6A:A6:EA:C3:D4:8B:3A:30:AB:18 SHA-256: 05:A2:2A:35:EE:F2:51:23:72:4D:72:67:A5:6A:8A:58:22:2C:00:A6:AB:F6:45:D5:A1:82:D8:90:A4:69:C8:FE Valid until: Wednesday, August 10, 2044
आपको ऊपर दिए गए कुछ आउटपुट दिखेंगे. SHA1
हैश, अहम लाइन है. अगर आपको अपना SHA1 हैश नहीं मिल रहा है, तो ज़्यादा जानकारी के लिए यह पेज देखें.
Firebase कंसोल पर वापस जाएं और अपने Android प्रोजेक्ट को Firebase प्रोजेक्ट के साथ रजिस्टर करने के लिए, यह तरीका अपनाएं:
- अपने नए प्रोजेक्ट की खास जानकारी वाली स्क्रीन पर, सेटअप वर्कफ़्लो लॉन्च करने के लिए, Android आइकॉन पर क्लिक करें:
- अगली स्क्रीन पर, अपने ऐप्लिकेशन के पैकेज के तौर पर
com.google.firebase.codelab.friendlychat
डालें. - Firebase कॉन्फ़िगरेशन फ़ाइल डाउनलोड करने के लिए, ऐप्लिकेशन रजिस्टर करें पर क्लिक करें. इसके बाद, google-services.json डाउनलोड करें पर क्लिक करें.
google-services.json
फ़ाइल को अपने Android प्रोजेक्ट कीapp
डायरेक्ट्री में कॉपी करें.- कंसोल के सेटअप वर्कफ़्लो में दिखाए गए अगले चरण अभी नहीं (ये आपके लिए
build-android-start
प्रोजेक्ट में पहले ही कर दिए गए हैं). - पक्का करें कि Gradle फ़ाइलों के साथ अपना प्रोजेक्ट सिंक करके, आपके ऐप्लिकेशन पर सभी डिपेंडेंसी उपलब्ध हैं. Android Studio के टूलबार में, फ़ाइल > Gradle फ़ाइलों के साथ प्रोजेक्ट सिंक करें चुनें. कॉन्फ़िगरेशन में किए गए बदलावों को लागू करने के लिए, आपको प्रोजेक्ट बनाएं/साफ़ करें और प्रोजेक्ट बनाएं/फिर से बनाएं को भी चलाना पड़ सकता है.
Firebase से पुष्टि करने की सुविधा को कॉन्फ़िगर करें
आपका ऐप्लिकेशन, उपयोगकर्ताओं की ओर से Firebase Authentication API को ऐक्सेस करने से पहले, आपको Firebase Authentication और उन साइन-इन प्रोवाइडर को चालू करना होगा जिनका इस्तेमाल आपको अपने ऐप्लिकेशन में करना है.
- Firebase कंसोल में, बाईं ओर मौजूद नेविगेशन पैनल से पुष्टि चुनें.
- साइन इन करने का तरीका टैब चुनें.
- ईमेल/पासवर्ड पर क्लिक करें. इसके बाद, स्विच को 'चालू है' (नीले रंग में) पर टॉगल करें.
- Google पर क्लिक करें. इसके बाद, स्विच को चालू (नीले) पर टॉगल करें और प्रोजेक्ट के लिए सहायता ईमेल पता सेट करें.
अगर आपको इस कोडलैब में बाद में "CONFIGURATION_NOT_FOUND" मैसेज के साथ गड़बड़ियां मिलती हैं, तो इस चरण पर वापस आएं और अपने काम की दोबारा जांच करें.
रीयलटाइम डेटाबेस सेट अप करें
इस कोडलैब के ऐप्लिकेशन में मौजूद ऐप्लिकेशन, चैट मैसेज को Firebase रीयल टाइम डेटाबेस में सेव करता है. इस सेक्शन में, हम एक डेटाबेस बनाएंगे और Firebase के सुरक्षा नियमों नाम की JSON कॉन्फ़िगरेशन भाषा का इस्तेमाल करके, उसकी सुरक्षा को कॉन्फ़िगर करेंगे.
- Firebase कंसोल के बाएं पैनल में, बिल्ड को बड़ा करें. इसके बाद, रीयल टाइम डेटाबेस चुनें.
- डेटाबेस बनाएं पर क्लिक करें.
- अपने डेटाबेस के लिए कोई जगह चुनें, फिर आगे बढ़ें पर क्लिक करें.
असल ऐप्लिकेशन के लिए, आपको वह जगह चुननी है जो आपके उपयोगकर्ताओं के आस-पास हो. - टेस्ट मोड में शुरू करें पर क्लिक करें. सुरक्षा नियमों के बारे में डिसक्लेमर पढ़ें.
इस कोडलैब के अगले चरणों में, आपको अपने डेटा को सुरक्षित रखने के लिए सुरक्षा नियम जोड़ने होंगे. अपने डेटाबेस के लिए सुरक्षा के नियम जोड़े बिना, किसी ऐप्लिकेशन को सार्वजनिक रूप से उपलब्ध न करें या उसे सार्वजनिक न करें. - बनाएं पर क्लिक करें.
- डेटाबेस इंस्टेंस बनाने के बाद, नियम टैब चुनें. इसके बाद, नियम के कॉन्फ़िगरेशन को इनकी मदद से अपडेट करें:
{ "rules": { "messages": { ".read": "auth.uid != null", ".write": "auth.uid != null" } } }
सुरक्षा नियमों के काम करने के तरीके के बारे में ज़्यादा जानने के लिए, रीयल टाइम डेटाबेस की सुरक्षा से जुड़ा दस्तावेज़ देखें. इसमें "auth" वैरिएबल के बारे में भी जानकारी दी गई है.
Firebase के लिए Cloud Storage सेट अप करना
- Firebase कंसोल के बाएं पैनल में, बिल्ड को बड़ा करें. इसके बाद, स्टोरेज चुनें.
- शुरू करें पर क्लिक करें.
- अपने डिफ़ॉल्ट स्टोरेज बकेट के लिए कोई जगह चुनें.
US-WEST1
,US-CENTRAL1
, औरUS-EAST1
के बकेट Google Cloud Storage के लिए "हमेशा मुफ़्त" टियर का फ़ायदा ले सकते हैं. अन्य सभी जगहों के बकेट, Google Cloud Storage के शुल्क और उसके इस्तेमाल के हिसाब से होते हैं. - टेस्ट मोड में चालू करें पर क्लिक करें. सुरक्षा के नियमों से जुड़ा डिसक्लेमर पढ़ें.
इस कोडलैब में, बाद में आपको अपने डेटा को सुरक्षित रखने के लिए सुरक्षा के नियम जोड़ने होंगे. स्टोरेज बकेट के लिए, सुरक्षा के नियम जोड़े बिना किसी ऐप्लिकेशन को सार्वजनिक तौर पर डिस्ट्रिब्यूटन करें. - बनाएं पर क्लिक करें.
Firebase के संसाधनों से कनेक्ट करना
इस कोडलैब के शुरुआती चरण में, आपने MainActivity.kt
में यह कोड जोड़ा था. इस कंडीशनल ब्लॉक ने आपके Android प्रोजेक्ट को Firebase Emulator Suite से कनेक्ट किया.
// REMOVE OR DISABLE THIS
if (BuildConfig.DEBUG) {
Firebase.database.useEmulator("10.0.2.2", 9000)
Firebase.auth.useEmulator("10.0.2.2", 9099)
Firebase.storage.useEmulator("10.0.2.2", 9199)
}
अगर आपको अपने ऐप्लिकेशन को अपने नए असल Firebase प्रोजेक्ट और उसके असल Firebase संसाधनों से कनेक्ट करना है, तो इस ब्लॉक को हटाएं या अपने ऐप्लिकेशन को रिलीज़ मोड में चलाएं, ताकि BuildConfig.DEBUG
false
हो.