/PortableAppsTemplate

Template repository for creating new PortableApps.com applications

Primary LanguagePowerShellOtherNOASSERTION

{{ UpstreamName }} for PortableApps.com

badge badge {{ AppName }}?include prereleases runs%20on Win64%20%26%20Win32 blue total

link:{{ UpstreamUrl }}[{{ UpstreamName }}] Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum.

Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum.

Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet.

Runtime dependencies

  • 32-bit or 64-bit version of Windows Vista or greater.

Support matrix

OS 32-bit 64-bit

ReactOS 0.4.14

no data

no data

ReactOS 0.4.15

no data

no data

Windows XP

no data

no data

Windows Vista

no data

no data

Windows 7

no data

no data

Windows 8

no data

no data

Windows 10

no data

no data

Windows 11

not applicable

no data

Legend: no support not supported; not applicable not applicable; no data no data; probably supported supported but not verified; full support verified;

Status

This PortableApps project is in beta stage.

Installation

Download

Since this is not an official PortableApp the PortableApps installer must be download first. Navigate to https://github.com/uroesch/{{ AppName }}/releases for a selection of releases.

Install via the PortableApps.com Platform

After downloading the .paf.exe installer navigate to your PortableApps.com platform Apps Menu ❶ and select Install a new app (paf.exe) ❷.

install newapp menu

From the dialog choose the previously downloaded .paf.exe file. ❸

install newapp dialog

After a short while the installation dialog will appear.

install newapp installation

Install outside of the PortableApps.com Platform

The Packages found under the release page are not digitally signed so there the installation is a bit involved.

After downloading the .paf.exe installer trying to install may result in a windows defender warning.

info defender protected

To unblock the installer and install the application follow the annotated screenshot below.

howto unblock file

  1. Right click on the executable file.

  2. Choose Properties at the bottom of the menu.

  3. Check the unblock box.

Build

Windows

Windows 10

The only supported build platform for Windows is version 10 other releases have not been tested.

Clone repositories
git clone https://github.com/{{ GitHubUser }}/PortableApps.comInstaller.git
git clone -b patched https://github.com/uroesch/PortableApps.comLauncher.git
git clone https://github.com/{{ GitHubUser }}/{{ AppName }}.git
Build installer
cd {{ AppName }}
powershell -ExecutionPolicy ByPass -File Other/Update/Update.ps1

Linux

Docker
ℹ️
This is currently the preferred way of building the PortableApps installer.

For a Docker build run the following command.

Clone repo
git clone https://github.com/{{ GitHubUser }}/{{ AppName }}.git
Build installer
cd {{ AppName }}
curl -sJL https://raw.githubusercontent.com/uroesch/PortableApps/master/scripts/docker-build.sh | bash

Local build

Ubuntu 20.04

To build the installer under Ubuntu 20.04 Wine, PowerShell, 7-Zip and when building headless Xvfb are required.

Setup
sudo snap install powershell --classic
sudo apt --yes install git wine p7zip-full xvfb

When building headless run the below command starts a virtual Xserver required for the build to succeed.

export DISPLAY=:7777
Xvfb ${DISPLAY} -ac &
Clone repositories
git clone https://github.com/{{ GitHubUser }}/PortableApps.comInstaller.git
git clone -b patched https://github.com/{{ GitHubUser }}/PortableApps.comLauncher.git
git clone https://github.com/{{ GitHubUser }}/{{ AppName }}.git
Build installer
cd {{ AppName }}
pwsh Other/Update/Update.ps1
Ubuntu 18.04

To build the installer under Ubuntu 18.04 Wine, PowerShell, 7-Zip and when building headless Xvfb are required.

Setup
sudo snap install powershell --classic
sudo apt --yes install git p7zip-full xvfb
sudo dpkg --add-architecture i386
sudo apt update
sudo apt --yes install wine32

When building headless run the below command starts a virtual Xserver required for the build to succeed.

export DISPLAY=:7777
Xvfb ${DISPLAY} -ac &
Clone repositories
git clone https://github.com/{{ GitHubUser }}/PortableApps.comInstaller.git
git clone -b patched https://github.com/{{ GitHubUser }}/PortableApps.comLauncher.git
git clone https://github.com/{{ GitHubUser }}/{{ AppName }}.git
Build installer
cd {{ AppName }}
pwsh Other/Update/Update.ps1