এই কুইকস্টার্টে, আপনি একটি ছোট স্যাম্পেল ডেটাবেস তৈরি ও ডিপ্লয় করবেন এবং iOS অ্যাপ থেকে এটি অ্যাক্সেস করবেন।
পূর্বশর্ত
এই কুইকস্টার্ট সম্পূর্ণ করতে, আপনার নিম্নলিখিতগুলি প্রয়োজন হবে:
- নিম্নলিখিত টুল ইনস্টল করা আছে এমন এনভায়রনমেন্ট:
- Xcode-এর সাম্প্রতিক ভার্সন।
- Firebase CLI। আপনার NPM ইনস্টল করা থাকলে, রান করুন:
অন্যথায়, ইনস্টলেশন সংক্রান্ত নির্দেশাবলীর জন্য ডকুমেন্ট দেখুন।npm install -g firebase-tools@latest
- Google অ্যাকাউন্ট।
টিউটোরিয়াল
| টিউটোরিয়াল | |
|---|---|
১. নতুন Xcode প্রোজেক্ট তৈরি করুনXcode-এ, অ্যাপ টেমপ্লেট ব্যবহার করে একটি নতুন প্রোজেক্ট তৈরি করুন। |
বান্ডিল শনাক্তকারী com.example.Quickstart সহ প্রোজেক্টের নাম Quickstart দিন।
|
২. Firebase প্রোজেক্ট শুরু করাআপনার Xcode প্রোজেক্টের প্রোজেক্ট ডিরেক্টরিতে পরিবর্তন করুন এবং এতে একটি Firebase প্রোজেক্ট শুরু করুন। |
cd ~/qs-iosfirebase login --reauthfirebase init dataconnectপ্রম্পট করা হলে, নিম্নলিখিত বিকল্পগুলি বেছে নিন:
অন্যান্য সব প্রম্পটের জন্য ডিফল্ট ভ্যালু গ্রহণ করুন। এরপর, আপনার Firebase প্রোজেক্টে iOS অ্যাপ রেজিস্টার করুন। firebase apps:create --bundle-id com.example.Quickstart ios ios-quickstartঅ্যাপ স্টোর আইডি নির্দিষ্ট করার জন্য প্রম্পট করা হলে, ধাপটি এড়িয়ে যেতে Enter টিপুন। firebase apps:sdkconfig ios -o Quickstart/GoogleService-Info.plistXcode-এ, ফাইল > "কুইকস্টার্ট"-এ ফাইল যোগ করুন বিকল্প বেছে নিন এবং
|
৩. GraphQL-এর উদাহরণ সংজ্ঞা পর্যালোচনা করুনSQL Connect-এ, আপনি GraphQL ব্যবহার করে আপনার সব ডেটাবেস স্কিমা ও অপারেশন সংজ্ঞায়িত করেন। আপনি যখন প্রোজেক্ট শুরু করেছিলেন, তখন Firebase CLI আপনাকে শুরু করতে সাহায্য করার জন্য কিছু উদাহরণ তৈরি করেছিল। |
dataconnect/schema/schema.gql (excerpt)
type Movie @table { title: String! imageUrl: String! genre: String } type MovieMetadata @table { movie: Movie! @unique rating: Float releaseYear: Int description: String } query ListMovies @auth(level: PUBLIC) { movies { id title imageUrl genre } } |
৪. আপনার স্কিমা ও অপারেশন ডিপ্লয় করুনআপনার ডেটাবেস স্কিমা, কোয়েরি বা মিউটেশনে যখনই কোনও পরিবর্তন করবেন, তখনই আপনাকে ডেটাবেসে আপনার পরিবর্তন কার্যকর করার জন্য সেগুলি ডিপ্লয় করতে হবে। |
|
৫. নমুনা ডেটা দিয়ে ডেটাবেস সিড করুনএই সিড ডেটা আপনাকে স্যাম্পেল অ্যাপ পরীক্ষা করার সময় দেখার জন্য কিছু দেবে। মনে রাখবেন যে এই ধাপে আপনি নির্বিচারে GraphQL কার্যকর করছেন, যা প্রশাসনিক কাজের জন্য অনুমোদিত। |
|
৬. iOS ক্লায়েন্ট SDK জেনারেট করুনএই কমান্ডটি আপনার GraphQL সংজ্ঞা ব্যবহার করে iOS ক্লায়েন্ট SDK তৈরি করে বিশেষ করে আপনার ডেটাবেসের জন্য। আপনি এই লাইব্রেরি আপনার ক্লায়েন্ট অ্যাপে ব্যবহার করেন যাতে সব ডেটাবেস অপারেশন করা যায়। আপনি একাধিক প্ল্যাটফর্মের জন্য লাইব্রেরি তৈরি করতে পারেন, যার মধ্যে রয়েছে
Android-এর জন্য Kotlin, ওয়েব-এর জন্য JavaScript এবং Flutter, |
public class ListMoviesQuery { // ... @MainActor public func execute( fetchPolicy: QueryFetchPolicy = .preferCache, ) async throws -> OperationResult<ListMoviesQuery.Data> { var variables = ListMoviesQuery.Variables() let ref = dataConnect.query( name: "ListMovies", variables: variables, resultsDataType: ListMoviesQuery.Data.self, publisher: .observableMacro) let refCast = ref as! QueryRefObservation<ListMoviesQuery.Data, ListMoviesQuery.Variables> return try await refCast.execute(fetchPolicy: fetchPolicy) } } |
৭. আপনার Xcode প্রোজেক্টে Firebase ডিপেন্ডেন্সি যোগ করুনSwift Package Manager ব্যবহার করে আপনার প্রোজেক্টে তৈরি করা লাইব্রেরি যোগ করুন। আপনি যখন জেনারেট করা লাইব্রেরি যোগ করবেন, তখন এটি ট্রানজিটিভভাবে Firebase কোর লাইব্রেরি এবং Firebase SQL Connect লাইব্রেরি অন্তর্ভুক্ত করবে। |
Xcode নেভিগেশন বারে,
ফাইল > প্যাকেজ ডিপেন্ডেন্সি যোগ করুন > লোকাল যোগ করুন বিকল্প বেছে নিন এবং তৈরি করা লাইব্রেরি,
|
৮. একটি নমুনা iOS ক্লায়েন্ট লিখুনএই সহজ iOS অ্যাপের মাধ্যমে
লক্ষ্য করুন যে অ্যাপটি তৈরি করা SDK থেকে একটি ফাংশন ব্যবহার করে প্রয়োজনীয় ডেটাবেস অ্যাক্সেস সম্পূর্ণ করে। |
import SwiftUI import FirebaseCore import FirebaseDataConnect import DataConnectGenerated @main struct QuickstartApp: App { init() { FirebaseApp.configure() } var body: some Scene { WindowGroup { ListMovieView() } } } struct ListMovieView: View { @State private var moviesData: ListMoviesQuery.Data? var body: some View { VStack { ForEach(moviesData?.movies ?? []) { movie in Text(movie.title) } } .task { let result = try? await DataConnect.exampleConnector .listMoviesQuery.execute() self.moviesData = result?.data } } } |
৯. অ্যাপটি ব্যবহার করে দেখুনXcode থেকে, উদাহরণ অ্যাপটি রান করে দেখুন এটি কীভাবে কাজ করে। |
|
পরবর্তী ধাপ
SQL Connect VS Code এক্সটেনশন ব্যবহার করে দেখুন
SQL Connect-এর সাহায্যে ডেভেলপ করার সময়, আমরা SQL Connect VS Code এক্সটেনশন ব্যবহার করার জন্য বিশেষভাবে সাজেস্ট করি। আপনি প্রাথমিক ডেভেলপমেন্ট এনভায়রনমেন্ট হিসেবে Visual Studio Code ব্যবহার না করলেও, এক্সটেনশনটি বেশ কিছু ফিচার প্রদান করে যা স্কিমা ও অপারেশন ডেভেলপমেন্টকে আরও সুবিধাজনক করে তোলে:
- একটি GraphQL ল্যাঙ্গুয়েজ সার্ভার, যা SQL Connect-এর জন্য নির্দিষ্ট সিনট্যাক্স চেকিং এবং অটোকমপ্লিট সাজেশন প্রদান করে
- আপনার কোডের সাথে সামঞ্জস্যপূর্ণ CodeLens বোতাম যা আপনাকে আপনার স্কিমা ডেফিনিশন ফাইল থেকে ডেটা পড়তে এবং লিখতে এবং আপনার অপারেশন ডেফিনিশন থেকে কোয়েরি এবং মিউটেশন এক্সিকিউট করতে দেয়।
- আপনার GraphQL সংজ্ঞার সাথে আপনার জেনারেট করা SDK অটোমেটিক সিঙ্ক করে রাখুন।
- সহজ করা লোকাল এমুলেটর সেট-আপ।
- প্রোডাকশনে সহজ ডেপ্লয়মেন্ট।
লোকাল ডেভেলপমেন্টের জন্য SQL Connect এমুলেটর ব্যবহার করুন
যদিও এই টিউটোরিয়াল আপনাকে দেখিয়েছে কীভাবে সরাসরি প্রোডাকশনে SQL Connect স্কিমা ও অপারেশন ডেপ্লয় করতে হয়, আপনি হয়ত অ্যাপ ডেভেলপ করার সময় প্রোডাকশন ডেটাবেসে পরিবর্তন করতে চাইবেন না। এর পরিবর্তে, SQL Connect এমুলেটর সেট-আপ করুন এবং প্রোডাকশনের পরিবর্তে এর সাথে ডেভেলপমেন্টের কাজ করুন। এমুলেটর একটি লোকাল PGlite ইনস্ট্যান্স সেট-আপ করে যা Cloud SQL-এ লাইভ PostgreSQL ইনস্ট্যান্সের মতো কাজ করে।
আপনার অ্যাপের জন্য কীভাবে স্কিমা ও অপারেশন লিখতে হয় তা জানুন
SQL Connect-এর সাহায্যে অ্যাপ ডেভেলপ করার সময়, আপনার স্কিমা ও অপারেশনের ডিজাইন হল প্রথম ও সবচেয়ে গুরুত্বপূর্ণ ডেভেলপমেন্ট টাস্কগুলির মধ্যে একটি যা আপনাকে সম্পূর্ণ করতে হবে।
- Firebase কনসোলে Gemini হল একটি AI টুল যা আপনার অ্যাপের ন্যাচারাল ল্যাঙ্গুয়েজ বিবরণ থেকে SQL Connect স্কিমা তৈরি করতে পারে। এই টুলটি আপনাকে খুব দ্রুত শুরু করতে সাহায্য করতে পারে, বিশেষ করে যদি আপনি আগে কখনও রিলেশনাল ডেটাবেস নিয়ে কাজ না করে থাকেন।
- এছাড়াও, আপনি GraphQL ব্যবহার করে সরাসরি ডেটাবেস স্কিমা, কোয়েরি ও মিউটেশন লিখতে পারবেন। SQL Connect স্কিমা ডিজাইন করুন লিঙ্কে দেওয়া নির্দেশিকা দিয়ে শুরু করুন এবং তারপর অপারেশন কীভাবে লিখতে হয় তা জানতে ফলো-আপ পৃষ্ঠাগুলি দেখুন।
SQL Connect থেকে কীভাবে রিয়েল-টাইম আপডেট পাবেন তা জানুন
আপনি SQL Connect ব্যবহার করে এমন ক্লায়েন্ট অ্যাপ্লিকেশন লিখতে পারেন যা রিয়েল টাইমে পরিবর্তিত ডেটার প্রতিক্রিয়া দেয়। SQL Connect থেকে রিয়েল-টাইম আপডেট পান দেখুন।