Skip to content

Commit

Permalink
Update documentation in accordance with the latest UI change
Browse files Browse the repository at this point in the history
Signed-off-by: sunilpaulmathew <[email protected]>
  • Loading branch information
sunilpaulmathew committed Nov 15, 2024
1 parent 587a32a commit a9b11c6
Show file tree
Hide file tree
Showing 12 changed files with 24 additions and 15 deletions.
2 changes: 1 addition & 1 deletion docs/pages/exports.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,5 +12,5 @@ permalink: /exports/

<p style="text-align: justify;"><tab1>The <b>Exported Apps</b> page linked to the main menu allow users to easily manage (install, share, and delete) already exported APK's and app bundles.</tab1></p>

<p style="text-align: center"><img src="https://raw.githubusercontent.com/SmartPack/PackageManager/master/fastlane/metadata/android/en-US/images/phoneScreenshots/9.jpg" alt="" width="250" height="500" /></p>
<p style="text-align: center"><img src="https://raw.githubusercontent.com/SmartPack/PackageManager/master/fastlane/metadata/android/en-US/images/phoneScreenshots/2.jpg" alt="" width="250" height="500" /></p>
<p style="text-align: center">Screenshot of the Exported Apps page of Package Manager</p>
3 changes: 3 additions & 0 deletions docs/pages/general.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,9 @@ permalink: /general/

<p style="text-align: justify;"><tab1>Before moving to the rest of this article, we would like to mention some important requirements to completely utilize the full potential of Package Manager. Although this application is available for non-rooted android users, please be noted that the restrictions imposed by the Android ecosystem don't allow userspace applications, like Package Manager, to manage many advanced features. As a result, Package Manager has little limited capabilities in a non-rooted environment than its rooted counterpart. Although rooting is considered an illegal activity by most OEM's, the process of rooting offers a user more control over the device. Unfortunately, more detailed information about rooting and its merits/demerits are beyond the scope of this article. Moreover, gaining root access requires different methods on different devices. For those who are interested to know more, we highly recommend checking out <a href="https://smartpack.github.io/android-rooting/" target="_blank">this</a> article as well as many other resources available on the web.</tab1></p>

<p style="text-align: justify;"><tab1>On the other hand, allowing access to <b>Shizuku API</b> will help Package Manager to do much more things that are otherwise possible only with root access. More details about configuring Shizuku can be found <a href="https://shizuku.rikka.app/guide/setup/" target="_blank">here</a>.</tab1></p>


This article is organized into a few categories and are
<ol>
<li><a href="{{ site.github.url }}/ui/">User Interface</a></li>
Expand Down
9 changes: 4 additions & 5 deletions docs/pages/sai.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,14 +12,13 @@ permalink: /sai/

<p style="text-align: justify;"><tab1>Another important feature available in this application is a powerful installer which handles APK's, Split APK's, and app bundles. As the name itself suggests, this feature allows the installation of individual and split APK's (multiple APK's bearing the same package id and signature) as well as app bundles (<b>xapk</b>, <b>apkm</b>, and <b>apks</b> bundles). Since Google promotes the distribution of app bundles than normal APK's via their app store, and not many applications are available to handle the installation of such bundles, this feature will be a good deal for Package Manager users.</tab1></p>

<p style="text-align: center"><img src="https://raw.githubusercontent.com/SmartPack/PackageManager/master/fastlane/metadata/android/en-US/images/phoneScreenshots/10.jpg" alt="" width="250" height="500" /></p>
<p style="text-align: center"><img src="https://raw.githubusercontent.com/SmartPack/PackageManager/master/fastlane/metadata/android/en-US/images/phoneScreenshots/7.jpg" alt="" width="250" height="500" /></p>
<p style="text-align: center">Screenshot of a Split APK Installation session</p>

In order to install multiple APK's or app bundles, please follow the guidelines

1. Click the top menu icon and select "<b>Installer</b>".
2. Package Manager will now open an in-built file picker to select the installation file(s).
3. In order to install an app bundle (<b>xapk</b>, <b>apkm</b>, or <b>apks</b> file), simply select the respective file and follow on-screen instructions.
4. To install split APK's, please be sure to follow the additional requirements listed below
1. Click the plus button from the main or "<b>Exported Apps</b> page".
2. In order to install an app bundle (<b>xapk</b>, <b>apkm</b>, or <b>apks</b> file), simply select the respective file and follow on-screen instructions.
3. To install split APK's, please be sure to follow the additional requirements listed below
1. All the necessary split APK's should be placed in a single folder.
2. Upon being prompted to select the installation files, please make sure to select all the necessary split APK's to avoid possible installation failure.
25 changes: 16 additions & 9 deletions docs/pages/ui.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,10 +20,18 @@ Other than the main title (app name itself), the top portion of the application
<ol>
<li><b>Search</b> - Search and categorize applications with a specific name/package id).</li>
<li><b>Sort</b> - Sort the applications by name or package id. This section also offers an option to reverse the application list order.</li>
<li><b>Menu</b> - Access to "Split APK Installer", "Exported Apps", "Settings" and the "About" pages of the app.</li>
<li><b>Reload</b> - Reload the entire application list.</li>
</ol>

<p style="text-align: center"><img src="https://raw.githubusercontent.com/SmartPack/PackageManager/master/fastlane/metadata/android/en-US/images/phoneScreenshots/13.jpg" alt="" width="250" height="500" /></p>




The bottom navigation bar of the application provides quick access links to <b>Exported Apps</b>, <b>Uninstalled Apps</b> (requires Root or Shizuku), and the <b>Settings</b> menu.

// Access to "Split APK Installer", "Exported Apps", "Settings" and the "About" pages of the app

<p style="text-align: center"><img src="https://raw.githubusercontent.com/SmartPack/PackageManager/master/fastlane/metadata/android/en-US/images/phoneScreenshots/4.jpg" alt="" width="250" height="500" /></p>
<p style="text-align: center">Screenshot of the App Info page of Package Manager</p>

<p style="text-align: justify;"><tab1>Upon clicking an individual item on the app list, Package Manager opens a new page having a number of separate tabs (depending on the selected application) that are easily scrollable to each other. The first tab will list the necessary information of the selected application and it includes</tab1></p>
Expand All @@ -38,7 +46,7 @@ Other than the main title (app name itself), the top portion of the application
<li><b>Certificate</b> - some details about the app signing certificate</li>
</ol>

<p style="text-align: justify;"><tab1>Moreover, this page also shows a number of buttons scattered throughout (some of them are visible only on rooted devices) and includes</tab1></p>
<p style="text-align: justify;"><tab1>Moreover, this page also shows a number of buttons scattered throughout (some of them are visible only on Root or Shizuku supported devices) and includes</tab1></p>

<ol>
<li><b>Open</b> - Open the selected application</li>
Expand All @@ -51,27 +59,26 @@ Other than the main title (app name itself), the top portion of the application
<li><b>Reset</b> - Reset the data folder of the selected application (root-only feature)</li>
</ol>

<p style="text-align: center"><img src="https://raw.githubusercontent.com/SmartPack/PackageManager/master/fastlane/metadata/android/en-US/images/phoneScreenshots/5.jpg" alt="" width="250" height="500" /></p>
<p style="text-align: center"><img src="https://raw.githubusercontent.com/SmartPack/PackageManager/master/fastlane/metadata/android/en-US/images/phoneScreenshots/9.jpg" alt="" width="250" height="500" /></p>
<p style="text-align: center">Screenshot of the Split APK's page of Package Manager</p>

<p style="text-align: justify;"><tab1>The second tab on this menu is only applicable for split APK's or app bundles where the app shows a complete list of individual APK's with an option to export them individually into the device storage. This feature is pretty useful as google is nowadays suggesting developers to provide their work as app bundles (not APK's). This feature, therefore, helps users to only backup the necessary APK files instead of the whole bundle. Moreover, it is also possible to <a href="{{ site.github.url }}/sai/">install</a> signed app bundles/split APK's using Package Manager (more details are available in a later stage of this article).</tab1></p>

<p style="text-align: center"><img src="https://raw.githubusercontent.com/SmartPack/PackageManager/master/fastlane/metadata/android/en-US/images/phoneScreenshots/4.jpg" alt="" width="250" height="500" /></p>
<p style="text-align: center"><img src="https://raw.githubusercontent.com/SmartPack/PackageManager/master/fastlane/metadata/android/en-US/images/phoneScreenshots/10.jpg" alt="" width="250" height="500" /></p>
<p style="text-align: center">Screenshot of the Permissions page of Package Manager</p>

<p style="text-align: justify;"><tab1>The next tab (<b>Permissions</b>) will be visible for any apps that declared at least one permission in its manifest file. On this page, Package Manager lists both the "<b>Granted</b>" as well as the '<b>Denied</b>" permissions of the selected application. This important feature gives users an easy way to check out the permissions enjoying each and every application installed on their device as it is an important privacy/security concern. In future releases, Package Manager likely offers an option to revoke dangerous permissions that are already granted by the user.</tab1></p>

<p style="text-align: center"><img src="https://raw.githubusercontent.com/SmartPack/PackageManager/master/fastlane/metadata/android/en-US/images/phoneScreenshots/2.jpg" alt="" width="250" height="500" /></p>
<p style="text-align: center"><img src="https://raw.githubusercontent.com/SmartPack/PackageManager/master/fastlane/metadata/android/en-US/images/phoneScreenshots/11.jpg" alt="" width="250" height="500" /></p>
<p style="text-align: center">Screenshot of the Operations page of Package Manager</p>

<p style="text-align: justify;"><tab1>The Operations (<b>AppOps</b>) page of Package Manager offers full (nearly) control over various operations handled by an application. However, note that manipulating some operations will affect normal the functioning of the application. As an example, disabling the "Camera" operation for an application using the camera hardware will permanently destroy its access to that hardware. Hence, these features shouldn't be used unless the user is fully aware of the consequences of his/her action. Also, please be aware that some operations are simply unchangeable.</tab1></p>

<p style="text-align: center"><img src="https://raw.githubusercontent.com/SmartPack/PackageManager/master/fastlane/metadata/android/en-US/images/phoneScreenshots/3.jpg" alt="" width="250" height="500" /></p>
<p style="text-align: center">Screenshot of the Activity page of Package Manager</p>
<p style="text-align: center"><img src="https://raw.githubusercontent.com/SmartPack/PackageManager/master/fastlane/metadata/android/en-US/images/phoneScreenshots/12

<p style="text-align: justify;"><tab1>The next tab on this page displays all the enabled activities related to the selected application.</tab1></p>

<p style="text-align: center"><img src="https://raw.githubusercontent.com/SmartPack/PackageManager/master/fastlane/metadata/android/en-US/images/phoneScreenshots/6.jpg" alt="" width="250" height="500" /></p>
<p style="text-align: center"><img src="https://raw.githubusercontent.com/SmartPack/PackageManager/master/fastlane/metadata/android/en-US/images/phoneScreenshots/13.jpg" alt="" width="250" height="500" /></p>
<p style="text-align: center">Screenshot of the Manifest page of Package Manager</p>

<p style="text-align: justify;"><tab1>Finally, the last tab on this page displays the manifest file (AndroidManifest.xml) of the selected application.</tab1></p>
Binary file modified fastlane/metadata/android/en-US/images/featureGraphic.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified fastlane/metadata/android/en-US/images/phoneScreenshots/1.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit a9b11c6

Please sign in to comment.