Forum Discussion
Combining optional packages and modification packages
In case anyone is interested, and just so I don't leave another dangling thread, this is the redesign we've ended up going with:
* All apps are included in the main package, but only the config tool has an entry point (ergo only one with a Start entry).
* Optional packages add simple exes that launch the existing applications from the main container. The exes are registered as entry points, effectively allowing us to add Start entries for the apps that are already installed in the main package.
* Since all the apps are actually in the main package, even though they are only enabled when the optional package is installed, they can all see any DLLs and whatnot that have been overlaid by modification packages relative to their assemblies - this means we can ship our separately licensed components without any problems.
This works for us since there isn't any licensing issues with the apps themselves, just the components we want to ship in modification packages, and we really just wanted the admin to be able to choose what they add to the Start menu. The apps themselves aren't very big either, so including them all in the main package isn't a problem.
Hopefully this is useful to anyone trying to do something similar. I'll also link here from the other thread for anyone getting here from a web search.
If I want to have a primary package with a modification package that contains either different files or registry settings and this modification package contains no entry-points (Shortcuts/FTAs, etc..) Then all I need is the primary package and a package created as a modification package.
I believe that it is necessary that files in the primary and modification package exist as VFS files in their respective packages for the layering to work. (This is a restriction that Microsoft should, and may have fixed, but as I've never seen that they did I always make the packages this way).
The modification package references the main package by using the full package family name, and may not be installed until after the primary package is installed.
As such, all changes made by the app when running with the modification package are redirected based on the primary package family name.
TIMOTHY_MANGAN Hi Tim, yes the basic case isn't an issue; main package can read files from a modification package no problem. What I'm having issues with is that Optional Packages don't seem to share the same context.
For context, this is what I'm trying to do (finally picking it back up): Multi Application Suite? - Microsoft Tech Community
So, what I have is:
* Main package, which is a simple configuration tool
* Several optional packages, all in a related set with the main package, which contain related but standalone applications in the suite. Customers may install any combination.
* In all of the packages, the entry points are inside the ProgramFilesX86 VFS directory.
* When I add a modification package with, say, a DLL, the main package can load it but the optional packages act like it doesn't exist.
* I've used Invoke-CommandInDesktopPackage to verify the modification package files are in the VFS, but I believe this is running the command in the context of the main package so doesn't help confirm what the optional package can see from its context.
* If I break-apart my suite, make one of the optional packages into a main package, then create a modification package containing the same file, the application can see it.
I've tried including the modification package inside the related set, but this has had no effect. The only way I can see to make an application load from a modification package is for the application itself to be the main package.
Why am I doing this? I wanted a single route to install different combinations of apps in an MSIX 'suite' (e.g. differently configured appinstaller files for different user groups, etc). The modification package that gets overlaid contains a separately-licensed plugin that should be accessible from all of the applications in the container - from what I'm seeing, this isn't achievable even though all the docs seem to indicate that optional packages should get the same VFS overlays as the main package.
I guess the problem I'm now having is that, because Microsoft hasn't documented optional packages at all well, I can't tell if this is intentional or a bug. It seems strange that optional packages can have entry points, all the docs say they share a VFS, but I'm finding they can't load the same files. If this is the case, then there's no way to customise an application with a modification package if it was delivered as an optional package, which seems like something of a gap. It also completely blocks MSIX for us, as the single experience was the main goal.
- As the previous poster said, the plot thickens! The issue appears to be around how the VFS is overlaid for optional packages, and what that means for relative paths:
Working (Main Package -> Modification Package):
* Given a main package with VFS\ProgramFilesX86\somefolder\myapp.exe
* Install a modification package that adds VFS\ProgramFilesX86\somefolder\somelib.dll and VFS\ProgramFilesX86\somefolder\someconfig.xml
* MyApp.exe can see both modification package files relative to itself; that is to say, for example, we could call File.ReadAllText("someconfig.xml") and it would succeed. .NET can also load somelib.dll without issue.
Not Working (Main Package -> Optional Package -> Modification Package)
* Given a main package with VFS\ProgramFilesX86\somefolder\myapp.exe
* Install an optional package that adds VFS\ProgramFilesX86\somefolder\myotherapp.exe
* Install a modification package that adds VFS\ProgramFilesX86\somefolder\somelib.dll and VFS\ProgramFilesX86\somefolder\someconfig.xml
* MyApp.exe can see both modification package files relative to itself.
* MyOtherApp.exe cannot see either somelib.dll or someconfig.xml relative to itself. .NET cannot load somelib.dll (FileNotFoundException).
Possible workaround (Main Package -> Optional Package -> Modification Package):
* Given a main package with VFS\ProgramFilesX86\somefolder\myapp.exe
* Install an optional package that adds VFS\ProgramFilesX86\somefolder\myotherapp.exe
* Install a modification package that adds VFS\Common AppData\somelib.dll and VFS\Common AppData\someconfig.xml
* Both MyApp.exe and MyOtherApp.exe can see and load someconfig.xml when we manually use the Environment.SpecialFolder enum to get the path to CommonAppData.
* Working theory is that if we use Assembly.LoadFrom(filepath) in MyOtherApp.exe, passing the CommonAppData\somelib.dll path we generated using the Environment.SpecialFolder enum, then we should (hopefully) be able to load the DLL before .NET tries to do it automatically.
The more I look into this, the more it seems like a bug in the way modificaiton package overlays are being applied when there are optional packages in place, as I cannot for the life of me see why you'd want it to work like this.JDHIntercede You'll probably need someone from Microsoft to confirm, but I suspect that optional packages are not designed to layer in as you'd like.
However, on Windows 11 (only, unfortunately), it might be possible to add a Shared Package Container (SPC) that lists your mainpackage and optional package. I think the modification package would automatically come in as long as it is deployed, but possibly that would need to be listed as well). The packages listed in the SPC are all considered optional, so what the user gets is independent of the SPC definition. The SPC is (unfortunately) separately installed as an XML file definition listing the packages and a layering order (in case there are any file/reg conflicts). The SPC may be installed either prior to or after any of the packages. See MSIX Shared Package Container - MSIX | Microsoft Docs
In case anyone is interested, and just so I don't leave another dangling thread, this is the redesign we've ended up going with:
* All apps are included in the main package, but only the config tool has an entry point (ergo only one with a Start entry).
* Optional packages add simple exes that launch the existing applications from the main container. The exes are registered as entry points, effectively allowing us to add Start entries for the apps that are already installed in the main package.
* Since all the apps are actually in the main package, even though they are only enabled when the optional package is installed, they can all see any DLLs and whatnot that have been overlaid by modification packages relative to their assemblies - this means we can ship our separately licensed components without any problems.
This works for us since there isn't any licensing issues with the apps themselves, just the components we want to ship in modification packages, and we really just wanted the admin to be able to choose what they add to the Start menu. The apps themselves aren't very big either, so including them all in the main package isn't a problem.
Hopefully this is useful to anyone trying to do something similar. I'll also link here from the other thread for anyone getting here from a web search.
