https://github.com/arnobt78/facebook-statustapper--andriodapp
StatusTapper is an R&D mobile app for a client, where one can update their status on Facebook by uploading a photo in character mode that includes editable text.
https://github.com/arnobt78/facebook-statustapper--andriodapp
andriod-app android-java java mobile-app xml
Last synced: 12 months ago
JSON representation
StatusTapper is an R&D mobile app for a client, where one can update their status on Facebook by uploading a photo in character mode that includes editable text.
- Host: GitHub
- URL: https://github.com/arnobt78/facebook-statustapper--andriodapp
- Owner: arnobt78
- Created: 2024-08-08T10:15:24.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2025-04-12T18:09:43.000Z (about 1 year ago)
- Last Synced: 2025-05-31T22:08:45.150Z (about 1 year ago)
- Topics: andriod-app, android-java, java, mobile-app, xml
- Language: Java
- Homepage:
- Size: 11.7 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Facebook Status Tapper - Android App
              
---
## Project Summary
**Facebook-StatusTapper-AndroidApp** is a hands-on Android demo project that lets users tap their mood, snap or pick a photo, and post a custom status—complete with character overlays—directly to Facebook. Designed as a research and demonstration tool, the app showcases UI/UX, image editing, and seamless Facebook SDK integration for social sharing.
This project is ideal for:
- Android learners exploring social media integration,
- Developers wanting to understand user-driven status sharing,
- Teams seeking a template for quick demo or R&D Android apps.
---
## Table of Contents
1. [Project Summary](#project-summary)
2. [Features](#features)
3. [Technology Stack](#technology-stack)
4. [Project Structure](#project-structure)
5. [How to Run / Usage Instructions](#how-to-run--usage-instructions)
6. [Functional Walkthrough](#functional-walkthrough)
7. [Key Components & APIs](#key-components--apis)
8. [Learning Notes](#learning-notes)
9. [Examples & Code Snippets](#examples--code-snippets)
10. [Keywords](#keywords)
11. [Contribution](#contribution)
12. [License](#license)
13. [Maintainer](#maintainer)
14. [Conclusion](#conclusion)
---
## Features
- **Facebook Status Update:** Instantly post photos and custom status messages to Facebook.
- **Character Mode:** Choose between 'boy' or 'girl' avatars for a personalized overlay.
- **Mood Embellishments:** Add emoji overlays (happy, angry, etc.) to express your feelings.
- **Editable Caption:** Input and edit your own status text before posting.
- **Intuitive UI:** Clean interface for effortless navigation and quick status sharing.
- **Image Preview:** See exactly how your status and photo will look before posting.
- **Demo Screenshots:** Visual walkthrough included above.
---
## Technology Stack
- **Platform:** Android (app module)
- **Programming Language:** Java
- **UI Layout:** XML
- **Build System:** Gradle
- **Key Libraries:** Facebook Android SDK
- **Other:** AndroidX, custom drawables, and utility classes
---
## Project Structure
```
Facebook-StatusTapper--AndriodApp/
├── app/
│ ├── src/
│ │ ├── main/
│ │ │ ├── java/
│ │ │ │ └── [package_name]/
│ │ │ │ ├── MainActivity.java
│ │ │ │ ├── CharacterSelectionActivity.java
│ │ │ │ └── ... (other activities, utils)
│ │ │ ├── res/
│ │ │ │ ├── layout/
│ │ │ │ ├── drawable/
│ │ │ │ └── values/
│ │ │ └── AndroidManifest.xml
│ └── build.gradle
└── README.md
```
- **Activities:** Handle user interaction, navigation, and Facebook integration logic.
- **Layouts:** XML-based UI for each screen (character picker, editor, preview, etc).
- **Drawables:** Contains assets (buttons, avatars, emoji overlays).
- **Utils:** Helper code for image composition and SDK handling.
---
## How to Run / Usage Instructions
1. **Clone the Repository**
```
git clone https://github.com/arnobt78/Facebook-StatusTapper--AndriodApp.git
cd Facebook-StatusTapper--AndriodApp
```
2. **Open in Android Studio**
- Start Android Studio.
- Choose "Open an existing project" and select this folder.
3. **Configure Facebook SDK**
- Create a Facebook App via [Facebook for Developers](https://developers.facebook.com/).
- Add your App ID to `AndroidManifest.xml` and follow the [official SDK setup guide](https://developers.facebook.com/docs/facebook-login/android/).
- Set up Facebook login permissions if needed.
4. **Build and Run**
- Connect an Android device or start an emulator.
- Press "Run" in Android Studio.
5. **Using the App**
- Pick your avatar (boy/girl).
- Select your mood/emoji overlay.
- Take or select a photo.
- Write your status message.
- Preview, then post directly to Facebook!
---
## Functional Walkthrough
1. **Character Selection:** Choose your avatar on the main screen.
2. **Mood Selection:** Tap an emoji overlay to reflect your mood.
3. **Photo Upload:** Snap a new photo or choose one from your gallery.
4. **Text Edit:** Enter a custom status message.
5. **Preview:** Review your composite image and status.
6. **Facebook Post:** Tap "Post" to share on your Facebook timeline.
---
## Key Components & APIs
- **MainActivity.java:** App entry point and navigation handler.
- **CharacterSelectionActivity.java:** Lets users select their avatar.
- **ImageEditorUtils.java:** Overlays emoji/mood icons onto photos.
- **Facebook SDK Integration:** Handles authentication and posting.
- **AndroidManifest.xml:** Declares permissions and SDK settings.
**Key Android Concepts Used:**
- Activities & Intents
- Custom Views and Drawables
- Runtime Permissions (Camera, Storage)
- Third-Party SDK integration
---
## Learning Notes
- **Facebook SDK Integration:** A great example of how to use third-party SDKs in an Android project.
- **Image Composition:** Learn how to overlay graphics (emoji, characters) on user photos.
- **Activity Navigation:** Experience managing separate flows for avatar, mood, and status editing.
- **UI Design:** The layouts and resource files show how to make user-friendly, visually engaging apps.
- **Permissions:** See how to request and handle runtime permissions for camera and storage.
---
## Examples & Code Snippets
**Posting an Image to Facebook (Pseudo-Java):**
```java
// Setup Facebook SDK and callback
CallbackManager callbackManager = CallbackManager.Factory.create();
SharePhoto photo = new SharePhoto.Builder()
.setBitmap(composedBitmap)
.build();
SharePhotoContent content = new SharePhotoContent.Builder()
.addPhoto(photo)
.build();
ShareDialog.show(this, content);
```
**Overlaying Mood Emoji (Pseudo-Java):**
```java
Bitmap original = ... // User-selected image
Bitmap overlay = ... // Selected emoji
Canvas canvas = new Canvas(original);
canvas.drawBitmap(overlay, left, top, null);
```
---
## Keywords
Android, Java, XML, Facebook SDK, Status Update, Character Mode, Mood, Emoji, Mobile App, Demo, R&D
---
## Contribution
This project is a demo and proof-of-concept. Feedback, suggestions, and PRs are welcome! Please open an issue or submit a pull request for improvements.
---
## License
This project is for demonstration purposes and may include proprietary elements. Contact the owner for licensing details.
---
## Maintainer
**[arnobt78](https://github.com/arnobt78)**
*All screenshots and images above retained from the original README as requested.*
---
## Conclusion
This project is a great starting point for Android developers who want to explore user-driven social sharing, image composition, and third-party SDK integration. Use it to learn, experiment, or as a template for your own creative mobile projects.
---
## Happy Coding! 🎉
Thank you!