Android Studio-তে নতুন প্রজেক্ট খুললে বাঁ দিকে ফাইলের একটা লম্বা তালিকা দেখতে পাবেন — app, java, res, gradle। নতুনদের বেশিরভাগ বিভ্রান্তি এখানেই: কোন ফাইলটা কী কাজ করে, আর কোথায় কোড লিখতে হয়।

এই লেখায় Android Studio প্রজেক্ট স্ট্রাকচার ভেঙে দেখানো হয়েছে — একেবারে উপরে থেকে নিচ পর্যন্ত। একবার বুঝে গেলে আর কখনো ফাইল খুঁজে ঘাবড়াবেন না।

প্রজেক্ট খুললেই যা দেখবেন

বাঁ দিকের প্যানেলের দৃশ্যটি বদলে দেখা যায় দুই উপায়ে। উপরে ড্রপডাউন থেকে Android বেছে নিলে গোছানো দৃশ্য দেখবেন, আর Project বেছে নিলে কম্পিউটারে যেভাবে ফাইলগুলো সাজানো, সেভাবে দেখবেন।

নতুনদের জন্য Android ভিউ-ই ভালো — এখানে গুরুত্বপূর্ণ ফাইলগুলো এক জায়গায় গোছানো থাকে। তবে জেনে রাখুন, Android ভিউ আসল ফোল্ডার নয় — এটা শুধু দেখানোর একটি সাজানো রূপ।

Android Studio প্রজেক্ট স্ট্রাকচার — app, manifests, java, res ও Gradle Scripts ফোল্ডারের গঠন — Android Studio-র Android ভিউ — app ফোল্ডারের ভেতরেই manifests, java আর res থাকে।

app ফোল্ডার — অ্যাপের আসল ঘর

পুরো প্রজেক্টে অনেক ফোল্ডার থাকতে পারে, কিন্তু আপনার অ্যাপের সবকিছু থাকে app ফোল্ডারে। বাকিগুলো মূলত সেটিংস আর নির্মাণের (build) ফাইল।

তার মানে — প্রজেক্টের নাম যা-ই হোক, কোড খুঁজতে হলে সোজা app এ যান। এর ভেতরে তিনটি প্রধান অংশ:

manifests — অ্যাপের পরিচয়পত্র।
java — সব Java কোড।
res — সব ছবি, লেখা ও লেআউট।

java ফোল্ডার — যেখানে কাজ হয়

এই ফোল্ডারে থাকে আপনার সব .java ফাইল। নতুন প্রজেক্টে সাধারণত তিনটি প্যাকেজ দেখবেন:

প্রথম প্যাকেজ — প্যাকেজের নাম সাধারণত com.example.myapp ধরনের হয়। এর ভেতরে থাকে MainActivity.java — অ্যাপ চালু হলে প্রথম যে ফাইলটি চলে।
androidTest — আসল ফোনে চালানোর পরীক্ষা।
test — কম্পিউটারেই চালানো দ্রুত পরীক্ষা।

অনেক সময় একই নামের ফোল্ডার দুইবার দেখবেন (java দুটো, res দুটো)। এতে ঘাবড়াবেন না — Android ভিউ একটাকে দেখায় "দেখতে ভালো লাগবে" বলে, আর অন্যটা আসল ফোল্ডার। কোড লেখার জন্য সবসময় প্রথমটা ব্যবহার করুন।

res ফোল্ডার — অ্যাপের চেহারা

res মানে resources — অর্থাৎ অ্যাপের চেহারা ও ভাষা। এখানে থাকে ছবি, লেখা, রঙ আর পর্দার নকশা। ভেতরে অনেক সাব-ফোল্ডার আছে, তবে শুরুতে মূল চারটি জানলেই চলে।

layout

প্রতিটি পর্দার নকশা এখানে XML ফাইলে লেখা হয়। নতুন প্রজেক্টে activity_main.xml পাবেন — এটাই প্রথম পর্দার গঠন। Android Studio-তে এই ফাইলে ড্র্যাগ করে বোতাম, লেখা, ছবি বসানো যায়।

drawable

অ্যাপের সব ছবি ও আঁকা (icon, ব্যাকগ্রাউন্ড, শেপ) এখানে থাকে। নাম সবসময় ছোট হাতের অক্ষরে, সংখ্যা বা আন্ডারস্কোর দিয়ে লিখুন — বড় হাতের অক্ষর বা স্পেস রাখলে অ্যাপ বিল্ডই হবে না।

values

অ্যাপের লেখা, রঙ আর মাপ এক জায়গায় রাখার জায়গা। যেমন strings.xml এ সব লেখা, colors.xml এ সব রঙ।

শুরুতে অ্যাপের সব লেখা সরাসরি লেআউটে না লিখে strings.xml এ রাখাই ভালো অভ্যাস। কারণ একই অ্যাপ অন্য ভাষায় চালাতে চাইলে শুধু এই ফাইল বদলালেই হয় — বাকি কোড ছুঁতে হয় না।

mipmap

অ্যাপের লঞ্চার আইকন এখানে আলাদা আলাদা আকারে থাকে — ছোট ফোন থেকে বড় ট্যাব পর্যন্ত সবখানে ঠিক দেখানোর জন্য।

AndroidManifest.xml কোথায় থাকে

এই ফাইলটি থাকে app → manifests ফোল্ডারে। অ্যাপের পরিচয়পত্র হিসেবে এটি Android সিস্টেমকে বলে দেয় — অ্যাপের নাম কী, কোন প্যাকেজ, কোন পর্দাগুলো আছে, আর কোন কোন অনুমতি লাগবে।

এটি নিয়ে বিস্তারিত আলাদা গাইডে পড়ুন — AndroidManifest.xml — অ্যাপের ব্লুপ্রিন্ট ও পরিচয়পত্র।

Gradle ও build.gradle

Gradle Scripts অংশে কয়েকটি build.gradle ফাইল দেখবেন। এগুলো কোনো কোড নয় — এগুলো নির্মাণের নির্দেশনা। কোথা থেকে লাইব্রেরি নামবে, অ্যাপের সংস্করণ কত, কোন Android ভার্সনের জন্য বানানো হবে — সব এখানে লেখা।

দুটি ফাইল সবচেয়ে বেশি দরকারি:

Project-level build.gradle — পুরো প্রজেক্টের সাধারণ সেটিংস।
Module-level build.gradle (অর্থাৎ app এর ভেতরেরটি) — আপনার অ্যাপের নিজের সেটিংস। নতুন লাইব্রেরি যোগ করতে সাধারণত এটিই সম্পাদনা করতে হয়।

Module-level ফাইলে যা থাকলে ভয় পাবেন না:

android {
    compileSdk 34                 // কোন Android ভার্সন দিয়ে কম্পাইল হবে
    defaultConfig {
        applicationId "com.example.myapp"
        minSdk 24                 // সর্বনিম্ন কোন ভার্সনে চলবে
        targetSdk 34              // কোন ভার্সনকে লক্ষ্য করে বানানো
        versionCode 1
        versionName "1.0"
    }
}

dependencies {
    implementation 'androidx.appcompat:appcompat:1.6.1'
}

minSdk মানে — এই সংখ্যার চেয়ে পুরনো Android ফোনে আপনার অ্যাপ চলবে না। কম রাখলে বেশি ফোনে চলবে, কিন্তু নতুন ফিচার ব্যবহার করা যাবে না।

Gradle সেটিংস বদলানোর পর Android Studio উপরে একটা বার্তা দেখায় — Sync Now চাপতে হয়। এটা না চাপলে নতুন সেটিংস কাজ করে না, আর কোডে লাল দাগ থেকে যায়।

নতুনরা যেসব ভুল করে

Android ভিউ আর Project ভিউ গুলিয়ে ফেলা — একই ফাইল দুই জায়গায় দেখা যায়, তাই ভাবেন ফাইল নকল হয়েছে।
ভুল build.gradle সম্পাদনা করা — নতুনদের সাধারণত app এর ভেতরেরটি লাগে, উপরেরটি নয়।
Sync চাপতে ভুলে যাওয়া — তারপর ভাবেন লাইব্রেরিটা কাজ করছে না।
drawable ফাইলের নামে বড় হাতের অক্ষর বা স্পেস রাখা — বিল্ড সাথে সাথে ব্যর্থ হয়।
res ফোল্ডারে অকারণ ফাইল জমা করা — অ্যাপের আকার বাড়ে, অথচ কাজে লাগে না।
সব লেখা লেআউটে সরাসরি লেখা — পরে অন্য ভাষায় করা কষ্টকর হয়ে যায়।

EnamNotes-এর ফ্রি Android কোর্স

EnamNotes-এ Android App Development with Java/XML কোর্সে প্রজেক্ট স্ট্রাকচার — app, java, res ও স্ক্রিপ্ট ফাইল — প্রত্যেকটা আলাদা ভিডিওতে দেখানো হয়েছে।

সাথে সাথে পড়ুন:

সাধারণ কিছু প্রশ্ন

java ফোল্ডার দুটো দেখাচ্ছে কেন?

একটা আসল ফোল্ডার, আরেকটা শুধু দেখানোর জন্য। Android ভিউ-এ ফাইলগুলো আলাদা জায়গায় সাজানো থাকে। কোড লেখার জন্য সবসময় প্রথম (উপরের) ফোল্ডারটি ব্যবহার করুন।

build.gradle আসলে কী কাজ করে?

এটি Gradle-কে বলে দেয় অ্যাপ কীভাবে বানাতে হবে — কোন Android ভার্সন, কোন লাইব্রেরি, কোন সংস্করণ। কোড নয়, বরং একটি নির্দেশনার তালিকা।

লাইব্রেরি যোগ করতে কোথায় লিখব?

Module-level build.gradle এর dependencies অংশে — অর্থাৎ app ফোল্ডারের ভেতরের ফাইলটিতে। তারপর Sync Now চাপতে ভুলবেন না।

res ফোল্ডারে নতুন ফোল্ডার বানাতে পারব?

বানাতে পারবেন, তবে নাম হবে নির্দিষ্ট কিছু — যেমন layout, drawable, values। Android Studio-তে ডান ক্লিক করে New → Android Resource Directory ব্যবহার করলে ভুল নাম হওয়ার ভয় থাকে না।

শেষ কথা

Android Studio প্রজেক্ট স্ট্রাকচার আসলে জটিল নয় — শুধু প্রথমবার দেখলে অনেক লাগে। মনে রাখুন একটাই সূত্র: আপনার অ্যাপের সবকিছু app ফোল্ডারে — কোড java তে, চেহারা res এ, পরিচয় manifests এ, আর নির্দেশনা build.gradle এ।

এই সূত্রটা ধরে রাখলে নতুন কোনো প্রজেক্ট খুললেও আর বিভ্রান্ত হবেন না। আর গোছানোভাবে শিখতে চাইলে শুরু করুন EnamNotes-এর ফ্রি Android কোর্স দিয়ে।