Installing on Windows/pt-br: Difference between revisions

From FreeCAD Documentation
(Created page with "Install on Windows")
 
(Updating to match new version of source page)
 
(77 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages/>
The easiest way to install FreeCAD on Windows is to download the installer below. <br>
{{DownloadWindowsStable}}


{{Docnav
After downloading the .msi (Microsoft Installer) file, just double-click on it to start the installation process.
|[[Feature_list/pt-br|Lista de Recursos]]
|[[Installing_on_Linux/pt-br|Instalando no Linux]]
}}


{{TOCright}}
Below is more information about technical options. If it looks daunting, don't worry! Most Windows users will not need anything more than the .msi to install FreeCAD and '''[[Getting started | Get started]]'''!


== Standard Installation ==


<div class="mw-translate-fuzzy">
=== Simple Microsoft Installer Installation ===
The easiest way to '''install FreeCAD on Windows''' is by using the installer above. This page describes the usage and the features of the ''Microsoft Installer'' for more installation options.
A maneira mais fácil de '''instalar o FreeCAD no Windows''' é usando o arquivo de instalação para download acima. Esta página descreve o uso e as características do ''Instalador NSIS'' para mais opções de instalação.
</div>


<div class="mw-translate-fuzzy">
If you would like to download either a 64 bit or unstable development version, see the [[Download]] page.
Se você quiser baixar a versão de desenvolvimento (que pode ser instável), veja a página [[Download/pt-br|Download]].
</div>


<div class="mw-translate-fuzzy">
Após baixar o arquivo .exe (NSIS Installer), clique duas vezes nele para iniciar o processo de instalação.
</div>


<div class="mw-translate-fuzzy">
=== Command Line Installation ===
Abaixo estão mais informações sobre algumas opções técnicas. No entanto, a maioria dos usuários não precisa mais do que os arquivos .exe acima. Vá para [[Getting started/pt-br|Introdução]] após completar a instalação.
With the ''msiexec.exe'' command line utility, additional features are available, like non-interactive installation and administrative installation.
</div>


==== Non-interactive Installation ====
== Installation for all users of the Windows system ==
With the command line
msiexec /i FreeCAD<version>.msi
installation can be initiated programmatically. Additional parameters can be passed at the end of this command line, like
msiexec /i FreeCAD-2.5.msi TARGETDIR=r:\FreeCAD25
==== Limited user interface ====
The amount of user interface that installer displays can be controlled with /q options, in particular:


By default FreeCAD will be installed for the user that executes the installer. If this user only has user permissions, the default installation path is:
* /qn - No interface
: {{FileName|C:\Users\<username>\AppData\Local\Programs\FreeCAD X.YY}}
* /qb - Basic interface - just a small progress dialog
* /qb! - Like /qb, but hide the Cancel button
* /qr - Reduced interface - display all dialogs that don't require user interaction (skip all modal dialogs)
* /qn+ - Like /qn, but display "Completed" dialog at the end
* /qb+ - Like /qb, but display "Completed" dialog at the end


If the installer is executed by an admin user, or you execute it as admin, you can choose if FreeCAD should be installed for all users of the system or just for you. The default is for all users.
==== Target directory ====
The property TARGETDIR determines the root directory of the FreeCAD installation. For example, a different installation drive can be specified with
TARGETDIR=R:\FreeCAD25
The default TARGETDIR is [WindowsVolume\Programm Files\]FreeCAD<version>.


If installed for all users, the default installation path is:
==== Installation for All Users ====
: {{FileName|C:\Program Files\FreeCAD X.YY}}
Adding
ALLUSERS=1
causes an installation for all users. By default, the non-interactive installation install the package just for the current user, and the interactive installation offers a dialog which defaults to "all users" if the user is sufficiently privileged.


==== Feature Selection ====
== Silent Installation ==
A number of properties allow selection of features to be installed, reinstalled, or removed. The set of features for the FreeCAD installer is


To install FreeCAD silently, you can execute the installer from the command line:
* DefaultFeature - install the software proper, plus the core libraries
* Documentation - install documentation
* Source code - install the sources
* ... ToDo


{{Code|lang=text|code=
In addition, ALL specifies all features. All features depend on DefaultFeature, so installing any feature automatically installs the default feature as well. The following properties control features to be installed or removed
FreeCAD-~.exe /S
}}
Default settings will be used for all options. A custom installation path can be specified in this manner:


{{Code|lang=text|code=
* ADDLOCAL - list of feature to be installed on the local machine
FreeCAD-~.exe /S /D=A path to FreeCAD with spaces
* REMOVE - list of features to be removed
}}
* ADDDEFAULT - list of features added in their default configuration (which is local for all FreeCAD features)
* REINSTALL - list of features to be reinstalled/repaired
* ADVERTISE - list of feature for which to perform an advertise installation


By default, even with silent installations, there will be a short popup when the installer is checked for corruption. This so-called cyclic redundancy check only takes a few seconds at most. To disable this corruption check:
There are a few additional properties available; see the MSDN documentation for details.


{{Code|lang=text|code=
With these options, adding
FreeCAD-~.exe /S /NCRC
ADDLOCAL=Extensions
}}
installs the interpreter itself and registers the extensions, but does not install anything else.


Note that this {{Incode|/NCRC}} flag is '''not recommended''' since the corruption check assures that the installer was e.g. completely downloaded.
=== Uninstallation ===
With
msiexec /x FreeCAD<version>.msi
FreeCAD can be uninstalled. It is not necessary to have the MSI file available for uninstallation; alternatively, the package or product code can also be specified. You can find the product code by looking at the properties of the Uninstall shortcut that FreeCAD installs in the start menu.


== Chocolatey ==
=== Administrative installation ===
With
msiexec /a FreeCAD<version>.msi
an "administrative" (network) installation can be initiated. The files get unpacked into the target directory (which should be a network directory), but no other modification is made to the local system. In addition, another (smaller) msi file is generated in the target directory, which clients can then use to perform a local installation (future versions may also offer to keep some features on the network drive altogether).


Using the [https://chocolatey.org/install Chocolatey] package manager is currently not recommended as that repository is no longer kept up-to-date.
Currently, there is no user interface for administrative installations, so the target directory must be passed on the command line.


<span id="Uninstallation"></span>
There is no specific uninstall procedure for an administrative install - just delete the target directory if no client uses it anymore.
== Desinstalação ==


To uninstall FreeCAD it is preferable to use the Windows tools for uninstalling software. Alternatively you can execute the uninstaller directly. This is the file:
=== Advertisement ===
: {{FileName|Uninstall-FreeCAD.exe}}
With
You can find it in the folder where FreeCAD is installed.
msiexec /jm FreeCAD<version>.msi
it would be possible, in principle, to "advertise" FreeCAD to a machine (with /ju to a user). This would cause the icons to appear in the start menu, and the extensions to become registered, without the software actually being installed. The first usage of a feature would cause that feature to be installed.


The uninstaller can also be executed silently using the command line:
The FreeCAD installer currently supports just advertisement of start menu entries, but no advertisement of shortcuts.


{{Code|lang=text|code=
=== Automatic Installation on a Group of Machines ===
Uninstall-FreeCAD.exe /S}}
With Windows Group Policy, it is possible to automatically install FreeCAD an a group of machines. To do so, perform the following steps:
#Log on to the domain controller
#Copy the MSI file into a folder that is shared with access granted to all target machines.
#Open the MMC snapin "Active Directory users and computers"
#Navigate to the group of computers that need FreeCAD
#Open Properties
#Open Group Policies
#Add a new policy, and edit it
#In Computer Configuration/Software Installation, choose New/Package
#Select the MSI file through the network path
#Optionally, select that you want the FreeCAD to be deinstalled if the computer leaves the scope of the policy.


Note that (silent) uninstallation will fail if there is a running instance of FreeCAD, even if that instance is not the version being uninstalled.
Group policy propagation typically takes some time - to reliably deploy the package, all machines should be rebooted.


=== Installation on Linux using Crossover Office ===


{{Docnav
You can install the windows version of FreeCAD on a Linux system using ''CXOffice 5.0.1''. Run ''msiexec'' from the CXOffice command line, assuming that the install package is placed in the "software" directory which is mapped to the drive letter "Y:":
|[[Feature_list/pt-br|Lista de Recursos]]
msiexec /i Y:\\software\\FreeCAD<version>.msi
|[[Installing_on_Linux/pt-br|Instalando no Linux]]
FreeCAD is running, but it has been reported that the OpenGL display does not work, like with other programs running under [[wikipedia:Wine (software)|Wine]] i.e. Google [[wikipedia:SketchUp|SketchUp]].
}}


{{Userdocnavi{{#translation:}}}}
{{docnav|Feature list|Install on Unix}}

[[Category:User Documentation]]
<languages/>

Latest revision as of 20:00, 26 January 2024

Standard Installation

A maneira mais fácil de instalar o FreeCAD no Windows é usando o arquivo de instalação para download acima. Esta página descreve o uso e as características do Instalador NSIS para mais opções de instalação.

Se você quiser baixar a versão de desenvolvimento (que pode ser instável), veja a página Download.

Após baixar o arquivo .exe (NSIS Installer), clique duas vezes nele para iniciar o processo de instalação.

Abaixo estão mais informações sobre algumas opções técnicas. No entanto, a maioria dos usuários não precisa mais do que os arquivos .exe acima. Vá para Introdução após completar a instalação.

Installation for all users of the Windows system

By default FreeCAD will be installed for the user that executes the installer. If this user only has user permissions, the default installation path is:

C:\Users\<username>\AppData\Local\Programs\FreeCAD X.YY

If the installer is executed by an admin user, or you execute it as admin, you can choose if FreeCAD should be installed for all users of the system or just for you. The default is for all users.

If installed for all users, the default installation path is:

C:\Program Files\FreeCAD X.YY

Silent Installation

To install FreeCAD silently, you can execute the installer from the command line:

FreeCAD-~.exe /S

Default settings will be used for all options. A custom installation path can be specified in this manner:

FreeCAD-~.exe /S /D=A path to FreeCAD with spaces

By default, even with silent installations, there will be a short popup when the installer is checked for corruption. This so-called cyclic redundancy check only takes a few seconds at most. To disable this corruption check:

FreeCAD-~.exe /S /NCRC

Note that this /NCRC flag is not recommended since the corruption check assures that the installer was e.g. completely downloaded.

Chocolatey

Using the Chocolatey package manager is currently not recommended as that repository is no longer kept up-to-date.

Desinstalação

To uninstall FreeCAD it is preferable to use the Windows tools for uninstalling software. Alternatively you can execute the uninstaller directly. This is the file:

Uninstall-FreeCAD.exe

You can find it in the folder where FreeCAD is installed.

The uninstaller can also be executed silently using the command line:

Uninstall-FreeCAD.exe /S

Note that (silent) uninstallation will fail if there is a running instance of FreeCAD, even if that instance is not the version being uninstalled.