AD_MAUI/README.md

Apple Music Clone

Project Overview

Apple Music allows users to listen to music, browse playlists, and interact with a sophisticated UI to control their playback.

This clone does not.

Apple Music Clone is an application built on the .NET MAUI (Multi-platform App UI) framework. It focuses on the Library "master-detail". As of the 20th of May 2023, it is a façade: only the View part of the project is serviceable.

The View

• Library ("master")

  Users can browse a Library of Album and select any album to inspect.

• Album ("detail")

  Users can browse an Album of Songs.

• Dark/Light theme

  This clone replicates the original dark/light themes by Apple music.

  To test this, you can change your device's (or your emulator's) display setting to dark/light theme.

• i18n: en, fr

  This clone supports two locales: English (by default), and French.

  To test this, you can change your device's (or your emulator's) primary language settings to English/French.

• Bottom bar

  In Apple Music, a consistent, stylish, slightly transparent bottom bar allows navigation between different views, and paying songs.

  In this clone, the bar is just eye-candy, and not even a little bit transparent.

• Top bar

  In Apple Music, a stylish, slightly transparent top bar contains certain menu options, and displays the name of the current section once the user has scrolled past the corresponding header.

  In this clone, the top bar is left at the OS default.

Installation

To run the Apple Music Clone, you must first install .NET MAUI. You can follow the official guide for the same.

Once MAUI is installed, clone this repository and open the AD_MAUI.sln Solution in Visual Studio.

If you don't have an Android emulator installed for Visual Studio already, open the Android Device Manager to take care of that. For reference, this project was tested on a Pixel 5 - API 33 (Android 13.0 - API 33).

When you're ready to run the project, please make sure you launch the AMC.View project as a Single startup project, if Visual Studio hasn't configured it that way automatically.

Some known limitations and shortcomings

Concerning the View part of this project:

• the bottom bar is inserted once in the Library view, and once in the Album view
  • instead, it should be incorporated in a main layout.
• the bottom bar's "top" part, AKA the player, has some repeated code.

  <ImageButton Source="{AppThemeBinding Light='icon_play.png', Dark='icon_play_dark.png'}" 
               Margin="{StaticResource SpaceS}"
               HorizontalOptions="End"
               VerticalOptions="Center"
               HeightRequest="{StaticResource SpaceML}"
               WidthRequest="{StaticResource SpaceML}" />
  
  <ImageButton Source="{AppThemeBinding Light='icon_next.png', Dark='icon_next_dark.png'}" 
               Margin="{StaticResource SpaceS}"
               HorizontalOptions="End"
               VerticalOptions="Center"
               HeightRequest="{StaticResource SpaceML}"
               WidthRequest="{StaticResource SpaceML}" />
  

  • instead, it should have been extracted into another reusable component, but there were difficulties in doing that -- having to do with the dark/light themes.
• the bottom bar is not as stylish as the original.
• the top bar was left to the OS default.
• and many others will join this list, no doubt.