Add Makefile and new installation methods supporting multi-user environments

.gitignore

@@ -3,3 +3,4 @@
 .last-settings
 mko.cpupower.policy
 *.mo
+target

Makefile

@@ -0,0 +1,37 @@
+PREFIX ?= /usr
+
+VERSION="8.0.0"
+GLIB_COMPILE_SCHEMAS = $(shell $(PKGCONFIG) --variable=glib_compile_schemas gio-2.0)
+EXTENSION_INSTALL_DIR = "$(PREFIX)/share/gnome-shell/extensions/[email protected]"
+EXTENSION_FILES="$(shell find . -path './.git' -prune -o -path './target' -prune -o -print)"
+
+build:
+	@echo Compiling schemas...
+	@glib-compile-schemas ./schemas
+
+clean:
+	@rm -r target
+
+package: build
+	@mkdir -p target
+	@zip target/cpupower-${VERSION}.zip "$(EXTENSION_FILES)"
+
+install: package
+	@mkdir -p "$(EXTENSION_INSTALL_DIR)"
+	@unzip -o target/cpupower-${VERSION}.zip -d "$(EXTENSION_INSTALL_DIR)"
+
+uninstall:
+	@rm -r "$(EXTENSION_INSTALL_DIR)"
+
+install-tool:
+	@./tool/installer.sh --prefix "$(PREFIX)" --tool-suffix "$(TOOL_SUFFIX)" install
+
+uninstall-tool:
+	@./tool/installer.sh --prefix "$(PREFIX)" --tool-suffix "$(TOOL_SUFFIX)" uninstall
+
+release:
+	@./scripts/release.sh "$(VERSION)"
+
+reload:
+	@echo Reloading extension '[email protected]'...
+	@gdbus call --session --dest org.gnome.Shell --object-path /org/gnome/Shell  --method org.gnome.Shell.Extensions.ReloadExtension [email protected]

README.md

@@ -11,6 +11,85 @@ Click on the CPU icon in the top bar of your Gnome shell and follow the installa
 You need to enter your root password to install a policy kit rule. This rule is used to set the clock
 frequency of your CPU with your user.
 
+### Installing for another (admin) user
+
+Impersonate the (non-admin) user, clone the git repository, and run the following command:
+
+> Note: Cloning and installing the extension while impersonating the other user, enables this user
+>       to install updates for this extension from extensions.gnome.org.
+
+```shell
+$ sudo -u username bash
+$ cd /tmp
+$ git clone https://github.com/martin31821/cpupower.git
+$ cd cpupower
+$ make install PREFIX=/home/username/.local
+```
+
+The user can enable the extension in his settings and install the polkit rule and `cpufreqctl` tool by using the included installation guide.
+
+#### Uninstalling
+
+The user can uninstall the tools in the settings of this extension. The extension itself can be removed from withing the extension settings or with this command:
+
+```shell
+$ make uninstall PREFIX=/home/username/.local
+```
+
+### Installing for another (non-admin) user
+
+Impersonate the (non-admin) user, clone the git repository, and run the following command:
+
+> Note: Cloning and installing the extension while impersonating the other user, enables this user
+>       to install updates for this extension from extensions.gnome.org. However, the tool **must**
+>       be updated and installed by an administrator. The extension may stop working after the user
+>       installed an update and may need updating of the tool by an administrator.
+
+```shell
+$ sudo -u username bash
+$ cd /tmp
+$ git clone https://github.com/martin31821/cpupower.git
+$ cd cpupower
+$ make install PREFIX=/home/username/.local
+```
+
+And with an admin user run the following commands:
+
+```shell
+$ sudo make install-tool TOOL_SUFFIX=username
+```
+
+> Note: Also, use this command to update the tool for another user in an outdated installation.
+
+The extension will work out-of-the-box for the specified user only!
+
+> Note: Using another PREFIX than `/usr` in this setup might include security risks and may not work.
+
+#### Uninstalling
+
+```shell
+$ sudo make uninstall PREFIX=/home/username/.local
+$ sudo make uninstall-tool TOOL_SUFFIX=username
+```
+
+### Installing for all users
+
+Clone the git repository and run the following command:
+
+```shell
+$ sudo make install install-tool
+```
+
+This will install the extensions, polkit rule, and the tool for all users on the system.
+
+#### Uninstalling
+
+Run the following command to uninstall:
+
+```shell
+$ sudo make uninstall uninstall-tool
+```
+
 ## Prerequisites
 
 You need to have an **Intel Core i CPU** of at least the **second Generation (2xxx Model Number)** and the following
@@ -20,3 +99,43 @@ software installed to use this extension:
 - Policykit (ships default with gnome)
 - intel_pstate needs to be enabled in the kernel (should be the default in almost all Distros)
 - bash
+
+## Developing
+
+### Option 1
+
+Clone the repository and run:
+
+```shell
+$ make install PREFIX=/home/username/.local
+```
+
+and reload the extension with:
+
+```shell
+$ make reload
+```
+
+### Option 2
+
+Clone the respository to `~/.local/share/gnome-shell/extensions/[email protected]` and reload the extension with:
+
+```shell
+$ make reload
+```
+
+You can now enable the extension in your extension settings.
+
+### Viewing log output
+
+```shell
+$ journalctl -t gnome-shell -f
+```
+
+### Creating a new release
+
+Only core contributors to this project can make a new release. To create one, run:
+
+```shell
+$ make release
+```