Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 5 additions & 6 deletions articles/gettingstarted/setting_up_a_developer_machine.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,18 +5,17 @@ Make sure you have the right prerequisites and meet the system requirements to d
## Prerequisites

* For the development environment, we recommend using Var:VisualStudioEdition.
* You need a licensed Var:ProductNameWithEdition or later installed on your development machine.

* If you develop against a version of the API distributed with one of RWS's publicly released applications (i.e. Var:ProductNameWithEdition), all required assemblies and files should be available alongside the application.
Make sure you have the latest release of Var:ProductName installed.

* We also recommend installing the **Var:ProductName SDK** on your machine.
After installing the **Var:ProductName SDK**, the **New Project** dialog box in Var:VisualStudioEdition displays additional project templates specific to Var:ProductName application development.
* You can get the latest version from the [developer hub](https://developers.rws.com/).
* You can get the latest version from the [public repository](https://github.com/RWS/trados-studio-vs-extension).
* Or you can install directly from Var:VisualStudioEdition -> Tools -> Extensions.

![Visual Studio Extensions](images/VisualStudioExtensions.png)

* If your implementations need to connect to a TM Server system, make sure that the TM Server also runs the latest version.
* If you develop against a version of the API distributed with one of RWS's publicly released applications (i.e. Var:ProductNameWithEdition), all required assemblies and files should be available alongside the application.
Make sure you have the latest release of Var:ProductName installed.

> [!NOTE]
>
> As the build output path for your implementations, choose Var:PluginPackedPath.
Expand Down
9 changes: 3 additions & 6 deletions articles/gettingstarted/studio_plugin_overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,12 +9,9 @@ For more information on building specific types of plug-ins, refer to the releva

## Var:ProductName Plug-in Support

The core Var:ProductName application uses a modular architecture consisting entirely of plug-ins.
These plug-ins are known as *system plug-ins*.
You cannot add system plug-ins to an existing Var:ProductName installation, and end-users cannot disable them.

In addition to system plug-ins, Var:ProductName supports various types of *third-party plug-ins*.
Third-party developers can build these plug-ins using the **Var:ProductName SDK** and deploy them into an existing Var:ProductName installation.
Var:ProductName exposes various public APIs that allow you to extend the application by building plug-ins that integrate with the core application and provide additional features and functionalities.
Third-party developers can build these plug-ins using the **Var:ProductName SDK** and deploy them into an
existing Var:ProductName installation.
This section focuses on third-party plug-in development and deployment.

Since Var:ProductName is a Microsoft .NET application, develop third-party plug-ins using **Microsoft .NET Framework 4.8**.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -101,140 +101,54 @@ Standalone integrations may require binding redirects. Example for `App.config`:
```xml
<?xml version="1.0" encoding="utf-8"?>
<configuration>
<configSections>
<section name="log4net" type="log4net.Config.Log4NetConfigurationSectionHandler, log4net" />
</configSections>
<startup useLegacyV2RuntimeActivationPolicy="true">
<supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.8" />
</startup>

<runtime>
<assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
<dependentAssembly>
<assemblyIdentity name="System.Memory"
publicKeyToken="cc7b13ffcd2ddd51"
culture="neutral" />
<bindingRedirect oldVersion="0.0.0.0-4.0.1.2"
newVersion="4.0.1.2" />
</dependentAssembly>
<dependentAssembly>
<assemblyIdentity name="System.Runtime.CompilerServices.Unsafe"
publicKeyToken="b03f5f7f11d50a3a"
culture="neutral" />
<bindingRedirect oldVersion="0.0.0.0-65535.65535.65535.65535"
newVersion="6.0.0.0" />
</dependentAssembly>
<dependentAssembly>
<assemblyIdentity name="Microsoft.Extensions.Logging"
publicKeyToken="adb9793829ddae60"
culture="neutral" />
<bindingRedirect oldVersion="0.0.0.0-65535.65535.65535.65535"
newVersion="8.0.0.0" />
</dependentAssembly>
<dependentAssembly>
<assemblyIdentity name="Microsoft.Extensions.Logging.Abstractions"
publicKeyToken="adb9793829ddae60"
culture="neutral" />
<bindingRedirect oldVersion="0.0.0.0-65535.65535.65535.65535"
newVersion="8.0.0.2" />
</dependentAssembly>
<dependentAssembly>
<assemblyIdentity name="Microsoft.Extensions.Options"
publicKeyToken="adb9793829ddae60"
culture="neutral" />
<bindingRedirect oldVersion="0.0.0.0-65535.65535.65535.65535"
newVersion="8.0.0.2" />
</dependentAssembly>
<dependentAssembly>
<assemblyIdentity name="System.Collections.Immutable"
publicKeyToken="b03f5f7f11d50a3a"
culture="neutral" />
<bindingRedirect oldVersion="0.0.0.0-65535.65535.65535.65535"
newVersion="8.0.0.0" />
</dependentAssembly>
<assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
<dependentAssembly>
<assemblyIdentity name="System.Text.Encoding.CodePages"
publicKeyToken="b03f5f7f11d50a3a"
culture="neutral" />
<bindingRedirect oldVersion="0.0.0.0-65535.65535.65535.65535"
newVersion="8.0.0.0" />
<assemblyIdentity name="Microsoft.Extensions.Logging.Abstractions" publicKeyToken="adb9793829ddae60" culture="neutral" />
<bindingRedirect oldVersion="0.0.0.0-65535.65535.65535.65535" newVersion="10.0.0.5" />
</dependentAssembly>
</assemblyBinding>
<assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
<dependentAssembly>
<assemblyIdentity name="System.Threading.Tasks.Extensions"
publicKeyToken="cc7b13ffcd2ddd51"
culture="neutral" />
<bindingRedirect oldVersion="0.0.0.0-4.2.0.1"
newVersion="4.2.0.1" />
<assemblyIdentity name="Microsoft.Bcl.AsyncInterfaces" publicKeyToken="cc7b13ffcd2ddd51" culture="neutral" />
<bindingRedirect oldVersion="0.0.0.0-10.0.0.8" newVersion="10.0.0.8" />
</dependentAssembly>
</assemblyBinding>
<assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
<dependentAssembly>
<assemblyIdentity name="System.Text.Json"
publicKeyToken="cc7b13ffcd2ddd51"
culture="neutral" />
<bindingRedirect oldVersion="0.0.0.0-8.0.0.6"
newVersion="8.0.0.6" />
<assemblyIdentity name="Microsoft.Extensions.DependencyInjection.Abstractions" publicKeyToken="adb9793829ddae60" culture="neutral" />
<bindingRedirect oldVersion="0.0.0.0-10.0.0.5" newVersion="10.0.0.5" />
</dependentAssembly>
</assemblyBinding>
<assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
<dependentAssembly>
<assemblyIdentity name="Microsoft.Bcl.AsyncInterfaces"
publicKeyToken="cc7b13ffcd2ddd51"
culture="neutral" />
<bindingRedirect oldVersion="0.0.0.0-8.0.0.0"
newVersion="8.0.0.0" />
<assemblyIdentity name="Microsoft.Extensions.Logging" publicKeyToken="adb9793829ddae60" culture="neutral" />
<bindingRedirect oldVersion="0.0.0.0-10.0.0.5" newVersion="10.0.0.5" />
</dependentAssembly>
</assemblyBinding>
<assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
<dependentAssembly>
<assemblyIdentity name="System.Diagnostics.DiagnosticSource"
publicKeyToken="cc7b13ffcd2ddd51"
culture="neutral" />
<bindingRedirect oldVersion="0.0.0.0-8.0.0.1"
newVersion="8.0.0.1" />
<assemblyIdentity name="Microsoft.Extensions.Primitives" publicKeyToken="adb9793829ddae60" culture="neutral" />
<bindingRedirect oldVersion="0.0.0.0-10.0.0.5" newVersion="10.0.0.5" />
</dependentAssembly>
</assemblyBinding>
<assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
<dependentAssembly>
<assemblyIdentity name="Microsoft.Extensions.DependencyInjection.Abstractions"
publicKeyToken="adb9793829ddae60"
culture="neutral" />
<bindingRedirect oldVersion="0.0.0.0-8.0.0.2"
newVersion="8.0.0.2" />
<assemblyIdentity name="System.Reflection.Metadata" publicKeyToken="b03f5f7f11d50a3a" culture="neutral" />
<bindingRedirect oldVersion="0.0.0.0-10.0.0.8" newVersion="10.0.0.8" />
</dependentAssembly>
</assemblyBinding>
<assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
<dependentAssembly>
<assemblyIdentity name="Microsoft.Extensions.DependencyInjection"
publicKeyToken="adb9793829ddae60"
culture="neutral" />
<bindingRedirect oldVersion="0.0.0.0-8.0.0.0"
newVersion="8.0.0.1" />
<assemblyIdentity name="System.Threading.Tasks.Extensions" publicKeyToken="cc7b13ffcd2ddd51" culture="neutral" />
<bindingRedirect oldVersion="0.0.0.0-4.2.4.0" newVersion="4.2.4.0" />
</dependentAssembly>
</assemblyBinding>
</runtime>

<log4net>
<!-- Set levels to DEBUG for extended logging information -->
<appender name="RollingFile" type="Sdl.Desktop.Logger.LocalUserAppDataFileAppender, Sdl.Desktop.Logger">
</appender>
<!-- output to debug string -->
<appender name="OutputDebug" type="log4net.Appender.OutputDebugStringAppender">
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="%date [%thread] %-5level %logger [%property{NDC}] - %message%newline" />
</layout>
</appender>
<root>
<level value="INFO" />
<appender-ref ref="RollingFile" />
<appender-ref ref="OutputDebug" />
</root>
<logger name="Sdl.TranslationStudio">
<level value="INFO" />
</logger>
<logger name="Sdl.Desktop">
<level value="INFO" />
</logger>
<logger name="Sdl.ProjectApi">
<level value="INFO" />
</logger>
<logger name="Licensing">
<level value="INFO" />
</logger>
<!--<logger name="Sdl.MultiTerm">
<level value="DEBUG"/>
</logger>-->
</log4net>
</configuration>
```
In most cases, this will be sufficient to enable proper interaction with the Studio APIs.
Expand Down
Loading