PortableCommandAlias reports alias added but does not create alias for ZIP portable package
Maintainer thường phản hồi trong vòng 2 ngày
Chưa có ai nhận issue này.
Đánh giá
- Độ khó
- 4/5
- Thời gian dự kiến
- 3-5 ngày
- Mức phù hợp với người mới
- 48/100
Hướng nghiên cứu
Start by tracing the portable package install path for ZIP installers and PortableCommandAlias, then inspect the link creation logic and its tests. Reproduce with the provided ARM64 system and x64 manifest, checking whether the executable path is accepted and whether a link is written to the user Links directory. Done means the alias invokes the extracted executable, or installation reports the link creation failure.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
Relevant area(s)
WinGet CLI
Relevant command(s)
winget install
Brief description of your issue
Installing a ZIP-based portable package with PortableCommandAlias: archy reports Command line alias added: "archy" and completes successfully, but no archy alias is actually created.
The package files are extracted correctly and the target x64 executable runs successfully when invoked directly. However, %LOCALAPPDATA%\Microsoft\WinGet\Links remains empty and archy cannot be resolved by where.exe, PowerShell Get-Command, or executed from the command line.
This is reproducible with a clean installation and from an elevated PowerShell session.
Steps to reproduce
- Create a multi-file WinGet manifest for
Genesys.Archyversion2.43.2. The relevant installer manifest is:
PackageIdentifier: Genesys.Archy
PackageVersion: 2.43.2
InstallerType: zip
NestedInstallerType: portable
NestedInstallerFiles:
- RelativeFilePath: archyBin\archy-win-2.43.2.exe
PortableCommandAlias: archy
Installers:
- Architecture: x64
InstallerUrl: https://sdk-cdn.mypurecloud.com/archy/2.43.2/archy-win.zip
InstallerSha256: 9D8D626E7D998EE7AC2FD753A1585674BB5C4B996806EDEC96D7D2DB5E725172
ManifestType: installer
ManifestVersion: 1.12.0
- Validate the manifest:
winget validate --manifest C:\Users\ascheble\manifests\g\Genesys\Archy\2.43.2
Result:
Manifest validation succeeded.
- Install the package:
winget install --manifest C:\Users\ascheble\manifests\g\Genesys\Archy\2.43.2
WinGet reports:
Found Archy [Genesys.Archy] Version 2.43.2
Downloading https://sdk-cdn.mypurecloud.com/archy/2.43.2/archy-win.zip
Successfully verified installer hash
Extracting archive...
Successfully extracted archive
Starting package install...
Command line alias added: "archy"
Successfully installed
- Verify that the package was extracted successfully:
Get-ChildItem "$env:LOCALAPPDATA\Microsoft\WinGet\Packages\Genesys.Archy__DefaultSource" -Recurse
The package contains:
Genesys.Archy__DefaultSource\
archy.bat
archyBin\
archy-win-2.43.2.exe
- Check the portable links directory:
Get-ChildItem "$env:LOCALAPPDATA\Microsoft\WinGet\Links" -Force
No archy alias/link is present.
- Close PowerShell and open a new PowerShell session, then check whether the reported alias is available:
where.exe archy
Result:
INFO: Could not find files for the given pattern(s).
PowerShell also cannot resolve the command:
Get-Command archy
Result:
The term 'archy' is not recognized as the name of a cmdlet, function, script file, or operable program.
Likewise:
archy version
fails because archy cannot be resolved.
The behavior is also reproducible when the installation is performed from an elevated PowerShell session. WinGet still reports:
Command line alias added: "archy"
but no corresponding alias is created.
Expected behavior
Given:
NestedInstallerFiles:
- RelativeFilePath: archyBin\archy-win-2.43.2.exe
PortableCommandAlias: archy
WinGet should create a usable archy command alias for the portable executable, such that:
archy version
invokes the installed archyBin\archy-win-2.43.2.exe.
If WinGet cannot create the requested alias, installation should report that failure rather than reporting:
Command line alias added: "archy"
Actual behavior
WinGet reports:
Command line alias added: "archy"
Successfully installed
but no alias is created.
%LOCALAPPDATA%\Microsoft\WinGet\Links remains empty, and:
where.exe archy
returns:
INFO: Could not find files for the given pattern(s).
The package itself is successfully downloaded and extracted to:
%LOCALAPPDATA%\Microsoft\WinGet\Packages\Genesys.Archy__DefaultSource
and the target executable exists at:
archyBin\archy-win-2.43.2.exe
Therefore the failure appears specific to creation of the requested PortableCommandAlias.
Environment
Windows Package Manager v1.29.380
Microsoft.DesktopAppInstaller v1.29.380.0
Windows: Windows.Desktop v10.0.26300.9711
System Architecture: Arm64
The package manifest specifies an x64 executable:
Architecture: x64
The x64 executable runs successfully on the ARM64 system using Windows Prism.
The issue was reproduced both normally and from an elevated PowerShell session.
Relevant `winget --info` paths:
Portable Links Directory (User)
%LOCALAPPDATA%\Microsoft\WinGet\Links
Portable Links Directory (Machine)
C:\Program Files\WinGet\Links
Portable Package Root (User)
%LOCALAPPDATA%\Microsoft\WinGet\Packages
Local manifests are enabled:
LocalManifestFiles Enabled
- Ngôn ngữ chính
- C++
- Star
- 26.6k
- Fork
- 1.8k
- Merge trung bình
- 3 ngày 10 giờ
- Pull request đã merge (30 ngày)
- 41
Chuẩn bị môi trường
- Không có Dockerfile hay tệp Docker Compose
- Có mẫu pull request
- Đọc hướng dẫn đóng góp
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của microsoft/winget-cli
-
Issue-Docs Needs-Triage
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 70/100
microsoft/winget-cli#6692 ·
Maintainer thường phản hồi trong vòng 2 ngày
-
Issue-Docs Possible-Duplicate
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 76/100
microsoft/winget-cli#6493 · 1 bình luận ·
Maintainer thường phản hồi trong vòng 2 ngày
-
WinGetSourceCreator: PackWithMappingFile should verify makeappx.exe exists before invoking itĐang mởIssue-Feature
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 68/100
microsoft/winget-cli#6427 ·
Maintainer thường phản hồi trong vòng 2 ngày
-
Issue-Docs msstore
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 64/100
microsoft/winget-cli#6331 · 1 bình luận ·
Maintainer thường phản hồi trong vòng 2 ngày
-
Command-Source Issue-Bug
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 68/100
microsoft/winget-cli#6148 ·
Maintainer thường phản hồi trong vòng 2 ngày
Tất cả issue của microsoft/winget-cli
Issue tương tự
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 75/100
stratum-mining/sv2-tp#167 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Sign up button opens the Sign in page instead of the Sign up page for Enterprise edition serversĐang mởauth bug ui/ux
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 72/100
MerginMaps/mobile#4795 ·
Maintainer thường phản hồi trong vòng 2 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 68/100
HarperFast/rocksdb-js#1118 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
bug triage
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 75/100
Maintainer thường phản hồi trong vòng 1 ngày
-
26.04 bug dark-mode Easy Hack impress symptom: visual
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 68/100
CollaboraOnline/online#16421 · 1 bình luận ·