Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

Integration tests across multiple FFmpeg versions

Đang mở
  • Có gì không ổn?
#392 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
5/5
Thời gian dự kiến
Hơn một tuần
Mức phù hợp với người mới
35/100
Loại issue
Tính năng
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Ít trao đổi
Công nghệ
java
Lĩnh vực
ci-cd, testing

Hướng nghiên cứu

Bắt đầu bằng cách xem xét cấu hình CI GitHub Actions hiện có và thiết lập kiểm thử Maven. Thêm profile tích hợp và các lớp kiểm thử vào src/test/java/.../integration/, với các tệp media mẫu trong src/test/resources/, sau đó thêm workflow riêng integration-test.yml được mô tả trong kế hoạch. Được coi là hoàn tất khi ma trận phiên bản chạy bộ kiểm thử tích hợp thực tế và xác minh các hành vi được liệt kê trên các phiên bản FFmpeg đã chỉ định.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

enhancement

Goal

Test the library against multiple FFmpeg versions to ensure compatibility and catch version-specific regressions.

Current State

  • CI runs on JDK 11, 17, 21 but only one FFmpeg version (release via setup-ffmpeg).
  • Unit tests mock FFmpeg — they don't exercise real FFmpeg behavior.
  • No integration tests that verify actual transcoding, probing, or option handling against a real FFmpeg binary.

Plan

1. Add FFmpeg version matrix to GitHub Actions
  • Extend the CI matrix to include multiple FFmpeg versions (e.g. 5.1, 6.1, 7.1, release).
  • Use FedericoCarboni/setup-ffmpeg which supports version pinning, or download specific builds from ffmpeg.org.
  • Matrix: {java: latest} x {ffmpeg: [5.1, 6.1, 7.1, release]}.
2. Create integration test suite
  • New test class(es) under src/test/java/.../integration/, gated behind a Maven profile (e.g. -Pintegration) so they don't run in normal unit test builds.
  • Tests should cover:
    • Probing: FFprobe.probe() against sample files — verify parsed codecs, streams, format, duration.
    • Transcoding: Basic transcode (e.g. mp4 to mkv, audio extraction) — verify output file is valid.
    • Builder options: Exercise every builder option (setVideoCodec, setAudioCodec, setFormat, setVideoFilter, setComplexFilter, setFrames, HLS output, etc.) and verify the resulting FFmpeg command succeeds.
    • Progress listener: Run a real transcode with ProgressListener and verify progress events are received.
    • Error handling: Feed invalid input and verify exceptions are thrown with useful messages.
    • Edge cases: Unicode filenames, paths with spaces, large filter strings.
3. Sample media files
  • Include small (< 1MB) sample media files in src/test/resources/ for integration tests.
  • Cover common formats: mp4 (h264+aac), mkv, webm, mp3, wav, etc.
4. CI workflow update
  • Add a separate job or workflow (integration-test.yml) that runs the integration profile.
  • Only run on push to main and PRs (not on every commit to avoid long CI times).

This is related to #31 (documenting supported FFmpeg versions) — once we have the test matrix, we can confidently document which versions are supported.

Ngôn ngữ chính
Java
Star
1.9k
Fork
424
Merge trung bình
1 ngày 16 giờ
Pull request đã merge (30 ngày)
15

Chuẩn bị môi trường

Dự án này không cung cấp dev container, Dockerfile hay hướng dẫn đóng góp, nên bạn cần tự thiết lập môi trường: hãy bắt đầu từ README và xem hướng dẫn đóng góp lần đầu của chúng tôi để biết các bước chung.

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. 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.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của bramp/ffmpeg-cli-wrapper

Tất cả issue của bramp/ffmpeg-cli-wrapper

Issue tương tự

Thêm issue về Java

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.