jefferyq / cyberduck

Cyberduck is a libre FTP, SFTP, WebDAV, Amazon S3, Backblaze B2, Microsoft Azure & OneDrive and OpenStack Swift file transfer client for Mac and Windows.

Cyberduck

Libre file transfer client for macOS and Windows. Command line interface (CLI) for Linux, macOS and Windows.

Prerequisites

• Oracle Java 1.8.0 SDK or later
• Apache Ant 1.10.1 or later
• Apache Maven 3.5 or later

macOS

• Xcode 9 or later

Windows

• Visual Studio 2017 or later
  • .NET Desktop development-Workload
  • Windows SDK (10.0.14393.0)
  • MSBuild Community Tasks
• Bonjour SDK for Windows

Building

Run mvn verify -DskipTests to build without running any tests.

Windows

You will run into errors by MSBuild/Wix that are unrelated to how Cyberduck is built. You may safely ignore them.

Debugging

macOS

Edit setup/app/Info.plist if you want to debug Cyberduck.app or setup/pkg/Info.plist if you want to debugduck respectively. Add -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=5005 to allow to connect to the running application in your IDE by attaching to the remote JVM.

Windows

Due to Visual Studio not being able to handle Java projects it is required to follow these steps for debugging:

• Run mvn verify -Dconfiguration=debug which ensures that debugging symbols are generated This prevents Visual Studio (or MSBuild invoked by mvn) from generating optimized assemblies which in turn may prevent debugging.

• Open the solution in Visual Studio

• Open a .java-File and set a break point. Visual Studio breaks either on or near the line selected.

• Debugging capabilities include

  • Step Over
  • Step Into
  • Step Out
  • Continue
  • Local/Auto variables
  • Immediate Window

  Go To Symbol is not working due to missing Java support.

Running Tests

After packaging, run mvn test -DskipITs to run unit tests but skip integration tests.

Maven Artifacts

Maven artifacts are available in a repository hosted on S3. Use the following Maven configuration to reference artifacts in your project:

     <repositories>
         <repository>
             <id>maven.cyberduck.io-release</id>
             <url>http://repo.maven.cyberduck.io.s3.amazonaws.com/releases/</url>
             <layout>default</layout>
             <releases>
                 <enabled>true</enabled>
             </releases>
             <snapshots>
                 <enabled>false</enabled>
             </snapshots>
         </repository>
     </repositories>

You will need to add the AWS Maven Wagon to your build:

     <build>
         <extensions>
             <extension>
                 <groupId>org.springframework.build</groupId>
                 <artifactId>aws-maven</artifactId>
                 <version>5.0.0.RELEASE</version>
             </extension>
         </extensions>
     </build>