block Puzzle is a relaxing yet addictive puzzle game where you drag and drop shapes to clear lines and chase your best score. Enjoy smooth animations, satisfying effects, and intuitive controls—perfect for quick breaks or long sessions.

How to play:

• Drag the blocks onto the grid
• Complete full rows or columns to clear them
• Keep the board from filling up to continue your streak
• Aim for combos to earn bonus points

• Sleek and intuitive UI
• Classic Block Puzzle gameplay
• Smooth animations and visual effects
• Interactive sounds and haptics
• Achievements and rewards
• High scores and detailed stats
• Multiple game modes (e.g., Classic)
• Auto-save progress
• Firebase push notifications (FCM)
• AdMob integration with GDPR (UMP)
• Flexible graphics/effects settings
• Lightweight and fast performance
• Offline play supported
• Easy text customization via strings.xml
• Store-ready project structure

• Android Studio (latest stable)
• JDK 17 (bundled with latest Android Studio is fine)
• Android SDK Platform 24–35 installed
• Android SDK Build-Tools 35.x
• Gradle wrapper (auto-handled by project)
• A physical Android device or emulator (API 24+)

• Install Android Studio (latest).
• Download/clone the project and open the folder 

  BlockPuzzle/
  
  

   in Android Studio.
• Let Gradle sync finish. If prompted to install SDK components, accept.

Basic Customization

• App name and texts: edit  app/src/main/res/values/strings.xml (key: 

  app_name
  
  

   and other UI texts).
• Colors/theme: edit 

  app/src/main/res/values/colors.xml
  
  

   and 

  res/values/themes/
  
  

  .
• App icon: Android Studio → File → New → Image Asset, then ensure manifest uses 

  @mipmap/ic_launcher
  
  

  .

AdMob (Ads)

• Where to change IDs:  app/src/main/res/values/strings.xml

  • admob_app_id
    
    

  • admob_banner_unit_id
    
    

  • admob_interstitial_unit_id
    
    

• Development: keep Google test IDs.
• Production: replace with your real AdMob IDs before release.

GDPR (UMP)

• Consent flow is built-in via 

  com.black.blockpuzzle.ads.AdsConsentManager
  
  

  .
• Ads load only if consent allows (already integrated in  StartActivity and  GameOverActivity).
• Ensure you have a Privacy Policy URL in your store listing. You can edit 

  app/src/main/assets/privacy_policy.html
  
  

  .

Firebase Push Notifications (FCM)

• Create a Firebase project → add Android app with package name 

  com.black.blockpuzzle
  
  

   (or your new package).
• Download 

  google-services.json
  
  

   and place it in 

  app/google-services.json
  
  

  .
• Sync Gradle. The app will log the FCM token on first run (search Logcat for “FCM token:”).

Common Edits

• Layouts/UI: 

  app/src/main/res/layout/
  
  

   (e.g.,  activity_start.xml,  activity_game_over.xml).
• Notification channel texts:  strings.xml (keys starting with 

  fcm_channel_
  
  

  ).
• Consent logic: 

  com.black.blockpuzzle.ads.AdsConsentManager
  
  

  .
• FCM service: 

  com.black.blockpuzzle.push.MyFirebaseMessagingService
  
  

  .

Package Name (Optional but recommended)

• Android Studio → right‑click 

  com.black.blockpuzzle
  
  

   → Refactor → Rename (Rename package).
• After changing, update Firebase to match and download a new 

  google-services.json
  
  

  .

Run and Test

• Connect a device or start an emulator (Android 7.0+, API 24+).
• Click Run to install a debug build.
• Verify:
  • Ads show with test IDs.
  • Consent dialog appears in GDPR regions (or configure UMP debug for testing).
  • Push notifications arrive (FCM token logs in Logcat).
  • Gameplay, sounds, and animations work as expected.

Build for Release

• Set 

  versionCode
  
  

   and 

  versionName
  
  

   in  app/build.gradle.kts → 

  defaultConfig
  
  

  .
• Build → Generate Signed Bundle / APK → select Android App Bundle (AAB).
• Create/choose keystore and finish the wizard. Upload the AAB to Play Console.

Before Publishing

• Replace test AdMob IDs with real ones.
• Ensure Privacy Policy is accessible (store listing and/or in‑app link).
• Test on multiple devices and Android versions.
• Confirm icons, screenshots, and listing text are ready.